---
title: "Create Clarity Process"
method: POST
path: "/v2/teams/{teamId}/clarity/processes"
tags: ["Clarity"]
---

# Create Clarity Process

`POST /v2/teams/{teamId}/clarity/processes`

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.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `name` string — Optional process name; server default applies when omitted

## Response `201`

Default Response

- object
  - `id` string, uuid, required — Created Clarity process id
  - `name` string, required — Process name
  - `status` 'draft' | 'collecting' | 'generating' | 'generating-current-process' | 'generating-transformation-proposal' | 'review' | 'complete' | 'generation_failed', required — Process lifecycle status
  - `version` 2, required — Always 2 for newly created processes
  - `createdAt` string, required — ISO 8601 creation timestamp

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — 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/versions/dafcf3d868a9/schema)