v1
latestOpenAPI 3.0.32026-07-222111928.0 KBClarityV2
List Clarity Processes
List Clarity processes for the current team, most recently updated first. Returns lightweight metadata (capture counts, contributors, status) suitable for building a picker; the per-process read model is available via GET /v2/teams/:team_id/clarity-v2/processes/:process_id for v2 rows and GET /v2/teams/:team_id/clarity/processes/:id for legacy v1 rows. Both v1 (legacy) and v2 processes are returned by default; use search, status, and version to narrow discovery. Capped at 100 per page.
get/v2/teams/{teamId}/clarity-v2/processes
Path parameters
teamIdstring required
Query parameters
limitinteger
Number of processes per page (1-100, default 50)
offsetinteger
Number of processes to skip (default 0)
searchstring
Case-insensitive search across process names
status'draft' | 'collecting' | 'generating' | 'generating-current-process' | 'generating-transformation-proposal' | 'review' | 'complete' | 'generation_failed'
Filter by process lifecycle status
versioninteger
Filter by Clarity process schema version: 1 legacy, 2 v2
Response
Default Response