Skip to main content
GET
/
queues
/
{queue_id}
/
cases
List cases
curl --request GET \
  --url https://api.duvo.ai/v1/queues/{queue_id}/cases \
  --header 'Authorization: Bearer <token>'
{
  "cases": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "queue_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "data": "<string>",
      "claimed_at": "<string>",
      "claimed_by_run_id": "<string>",
      "completed_at": "<string>",
      "postponed_to": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "created_by_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_by_user_name": "<string>",
      "created_by_user_email": "<string>",
      "agent_run_status": "<string>",
      "agent_run_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "pending_human_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "pending_approval_batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "pending_approval_assignee_user_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "approval_approved_count": 4503599627370495,
      "approval_rejected_count": 4503599627370495,
      "labels": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "key": "<string>",
          "value": "<string>",
          "color_hue": 180
        }
      ],
      "search_match_data_snippet": {
        "before": "<string>",
        "match": "<string>",
        "after": "<string>"
      }
    }
  ],
  "total": 123,
  "limit": 0,
  "offset": 0
}

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

queue_id
string<uuid>
required

The queue's unique identifier

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})$

Query Parameters

limit
integer
default:20

Number of cases per page (1-100, default 20).

Required range: 1 <= x <= 100
offset
integer

Zero-based offset for pagination.

Required range: 0 <= x <= 9007199254740991
status
string

Filter by one or more case statuses (comma-separated). Values: pending, claimed, completed, failed, needs_input, postponed.

Full-text search across case title and data.

created_at_from
string

Return only cases created on or after this ISO-8601 timestamp.

updated_at_from
string

Return only cases updated on or after this ISO-8601 timestamp.

sort_by
enum<string>
default:created_at

Field to sort by. Default: created_at.

Available options:
created_at,
updated_at,
postponed_to
sort_order
enum<string>
default:desc

Sort direction. Default: desc.

Available options:
asc,
desc

Response

Default Response

cases
object[]
required
total
number
required
limit
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
offset
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991