---
title: "Generate Clarity Process Snapshot"
method: POST
path: "/v2/clarity-v2/processes/{process_id}/snapshots/{kind}/generate"
tags: ["ClarityV2"]
---

# Generate Clarity Process Snapshot

`POST /v2/clarity-v2/processes/{process_id}/snapshots/{kind}/generate`

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.

## Path parameters

- `process_id` string, uuid, required
- `kind` 'current_process' | 'transformation_proposal', required

## Request body

- object
  - `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.
  - `transformation_aggressiveness` 'none' | 'conservative' | 'aggressive' — Transformation proposals only: controls how much the generated proposal should change the current process structure.

## Response `202`

Default Response

- object
  - `success` true, required — Generation kickoff was accepted

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)