v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

ClarityV2

Generate Clarity Process Snapshot

Trigger a snapshot generation pipeline for a v2 clarity process, selected by kind. current_process runs the generateCurrentProcess pipeline (body fields are proposal-only and rejected); transformation_proposal runs the generate or regenerate proposal pipeline. Returns 202 immediately and finalises asynchronously via the cc-server webhook stream.

post/v2/clarity-v2/processes/{process_id}/snapshots/{kind}/generate

Path parameters

process_idstring uuid required

The clarity process id

kind'current_process' | 'transformation_proposal' required

Snapshot kind to list

Request body

source_snapshot_idstring 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_fromstring 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_guidancestring

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

transformation_aggressiveness'none' | 'conservative' | 'aggressive'

Transformation proposals only: controls how much the generated proposal should change the current process structure.

Response

Default Response

successtrue required

Generation kickoff was accepted