Skip to main content
GET
/
clarity-v2
/
processes
/
{process_id}
Get process
curl --request GET \
  --url https://api.duvo.ai/v1/clarity-v2/processes/{process_id} \
  --header 'Authorization: Bearer <token>'
{
  "process": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "version": 0,
    "generation_error": "<string>",
    "generation_progress": {
      "steps": [
        {
          "key": "<string>",
          "label": "<string>",
          "order": 123,
          "count": 123
        }
      ]
    },
    "custom_prompt": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  },
  "current_process_versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "process_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_current_process_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sandbox_id": "<string>",
      "last_session_id": "<string>"
    }
  ],
  "transformation_proposal_versions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "process_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "clarity_current_process_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_transformation_proposal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "<string>",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sandbox_id": "<string>",
      "last_session_id": "<string>",
      "extra_capture_requests": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "proposal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "step_id": "<string>",
          "capture_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "requested_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "gap": "<string>",
          "suggested_prompt": "<string>",
          "created_at": "<string>",
          "updated_at": "<string>"
        }
      ]
    }
  ],
  "captures": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "processId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "videoUrl": "<string>",
      "videoTranscript": "<string>",
      "transcript": [
        {
          "message": "<string>",
          "timestamp": 123
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "userName": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
process_id
string<uuid>
required

The clarity process id

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Response

Default Response

​
process
object
required
​
current_process_versions
object[]
required

All non-deleted current-process snapshots, newest first. Lightweight rows (no data) for the version-picker UI. Clients lazy-fetch the live (or selected) snapshot via the per-snapshot detail endpoint.

​
transformation_proposal_versions
object[]
required

All non-deleted transformation-proposal snapshots, newest first. Lightweight rows (no data) for the version-picker UI.

​
captures
object[]
required

All captures (videos, interviews, documents) attached to this process. Field names follow the legacy v1 capture wire format (camelCase) so existing capture consumers keep working unchanged.