v1

latestOpenAPI 3.0.32026-07-222111928.0 KB
Clarity

Create Clarity Process

Create a new Clarity v2 process for the current team (manager+). Optional name defaults server-side when omitted. Response uses camelCase createdAt to match existing FE clients.

post/v2/teams/{teamId}/clarity/processes

Path parameters

teamIdstring required

Request body

namestring

Optional process name; server default applies when omitted

Response

Default Response

idstring uuid required

Created Clarity process id

namestring required

Process name

status'draft' | 'collecting' | 'generating' | 'generating-current-process' | 'generating-transformation-proposal' | 'review' | 'complete' | 'generation_failed' required

Process lifecycle status

version2 required

Always 2 for newly created processes

createdAtstring required

ISO 8601 creation timestamp