Skip to main content
POST
/
v2
/
clarity-v2
/
processes
/
{process_id}
/
transformation-proposal
Generate Clarity Transformation Proposal
curl --request POST \
  --url https://api.duvo.ai/v2/clarity-v2/processes/{process_id}/transformation-proposal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transformation_aggressiveness": "aggressive"
}
'
{
  "success": true
}

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

​
process_id
string<uuid>
required

The clarity process id

Body

application/json
​
current_process_id
string<uuid>

ID of a clarity_current_process row to anchor the new proposal to. When supplied, runs the generate pipeline against that snapshot. Defaults to the latest snapshot for the process.

​
regenerate_from
string<uuid>

ID of a clarity_transformation_proposal row to refine. When supplied, runs the regenerate pipeline using that proposal's current-process snapshot as the anchor and the extra captures collected since.

​
custom_guidance
string

Optional freeform guidance for this transformation proposal generation. Used as high-priority design guidance, not source-of-truth evidence.

Maximum string length: 2000
​
transformation_aggressiveness
enum<string>
default:aggressive

Controls how much the generated proposal should change the current process structure.

Available options:
none,
conservative,
aggressive

Response

Default Response

​
success
enum<boolean>
required

Generation kickoff was accepted

Available options:
true