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

# Create Clarity Process

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

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/teams/{teamId}/clarity/processes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/teams/:teamId/clarity/processes/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)