Skip to main content
POST
Generate Clarity Process Snapshot

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