Skip to main content
POST
/
v2
/
clarity-v2
/
processes
/
{process_id}
/
snapshots
/
{kind}
/
generate
Generate Clarity Process Snapshot
curl --request POST \
  --url https://api.duvo.ai/v2/clarity-v2/processes/{process_id}/snapshots/{kind}/generate \
  --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

​
kind
enum<string>
required

Snapshot kind to list

Available options:
current_process,
transformation_proposal

Body

application/json
​
source_snapshot_id
string<uuid>

Transformation proposals only: id of the current-process snapshot to anchor the new proposal to. Defaults to the latest snapshot for the process.

​
regenerate_from
string<uuid>

Transformation proposals only: id of a prior proposal snapshot 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

Transformation proposals only: optional freeform guidance for this generation. Used as high-priority design guidance, not source-of-truth evidence.

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

Transformation proposals only: 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