Generate Clarity Transformation Proposal

Trigger a transformation-proposal pipeline for a v2 clarity process. With no body or current_process_id, runs the generate pipeline against the chosen current-process snapshot (latest by default). With regenerate_from: <previousProposalId>, runs the regenerate pipeline anchored to the prior proposal’s current-process and the extra captures collected since. Returns 202 immediately and finalises asynchronously via the cc-server webhook stream.

POST /v2/clarity-v2/processes/{process_id}/transformation-proposal

Generate Clarity Transformation Proposal

cURL

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 '{}'

202

{}

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.

Response

202

application/json

Default Response

success · enum<boolean> · required

Generation kickoff was accepted

Available options: true