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

List Clarity Processes

cURL

curl --request GET \
  --url https://api.duvo.ai/v2/teams/{teamId}/clarity-v2/processes \
  --header 'Authorization: Bearer <token>'

200

{
  "processes": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "version": 0,
      "capture_count": 0,
      "pending_invitation_count": 0,
      "contributors": [
        {
          "user_id": "<string>",
          "user_name": "<string>"
        }
      ],
      "created_at": "<string>",
      "updated_at": "<string>",
      "created_by_name": "<string>",
      "capture_counts": {
        "video": 0,
        "interview": 0,
        "document": 0
      }
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId · string · required

Query Parameters

limit · integer · default: 50

Number of processes per page (1-100, default 50)

Required range: 1 <= x <= 100

offset · integer

Number of processes to skip (default 0)

Required range: 0 <= x <= 9007199254740991

search · string

Case-insensitive search across process names

Required string length: 1 - 200

status · enum<string>

Filter by process lifecycle status

Available options: draft, collecting, generating, generating-current-process, generating-transformation-proposal, review, complete, generation_failed

version · integer

Filter by Clarity process schema version: 1 legacy, 2 v2

Required range: -9007199254740991 <= x <= 9007199254740991

Response

200

application/json

Default Response

processes · object[] · required

Show child attributes

total · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

limit · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

offset · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991