Cases

Create, list, and manage cases and their labels within queues

get

List cases in a queue. Supports status, date-range, and free-text filters via query params. For label filters, use POST /v1/queues/:queue_id/cases/search.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

limitinteger · min: 1 · max: 100Optional

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

Default: 20

offsetinteger · max: 9007199254740991Optional

Zero-based offset for pagination.

statusstringOptional

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

searchstringOptional

Full-text search across case title and data.

created_at_fromstringOptional

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

updated_at_fromstringOptional

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

sort_bystring · enumOptional

Field to sort by. Default: created_at.

Default: created_atPossible values:

sort_orderstring · enumOptional

Sort direction. Default: desc.

Default: descPossible values:

Responses

200

Default Response

application/json

totalnumberRequired

limitinteger · min: -9007199254740991 · max: 9007199254740991Required

offsetinteger · min: -9007199254740991 · max: 9007199254740991Required

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/queues/{queue_id}/cases

HTTPcURLJavaScriptPython

GET /v1/queues/{queue_id}/cases HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "cases": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "queue_id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "data": "text",
      "status": "pending",
      "claimed_at": "text",
      "claimed_by_run_id": "text",
      "completed_at": "text",
      "postponed_to": "text",
      "created_at": "text",
      "updated_at": "text",
      "created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_by_user_name": "text",
      "created_by_user_email": "text",
      "agent_run_status": "text",
      "agent_run_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_human_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_approver_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "approval_approved_count": 1,
      "approval_rejected_count": 1,
      "search_match_data_snippet": {
        "before": "text",
        "match": "text",
        "after": "text"
      },
      "labels": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text",
          "color_hue": 1
        }
      ]
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

post

Create one or more cases in a queue. Provide either a single case object or a cases array (1-100); providing both returns 400. Each case accepts a title (max 500 chars), optional free-form data, and optional labels that will be assigned to the case on creation (missing labels are created on the queue).

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

Responses

201

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "case": {
    "title": "text",
    "data": "text",
    "labels": [
      {
        "key": "",
        "value": "text"
      }
    ]
  },
  "cases": [
    {
      "title": "text",
      "data": "text",
      "labels": [
        {
          "key": "",
          "value": "text"
        }
      ]
    }
  ]
}

{
  "added_cases": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "queue_id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "data": "text",
      "status": "pending",
      "claimed_at": "text",
      "claimed_by_run_id": "text",
      "completed_at": "text",
      "postponed_to": "text",
      "created_at": "text",
      "updated_at": "text",
      "created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_by_user_name": "text",
      "created_by_user_email": "text",
      "agent_run_status": "text",
      "agent_run_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_human_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_approver_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "approval_approved_count": 1,
      "approval_rejected_count": 1,
      "search_match_data_snippet": {
        "before": "text",
        "match": "text",
        "after": "text"
      },
      "labels": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text",
          "color_hue": 1
        }
      ]
    }
  ]
}

delete

Delete every case in a queue. Interrupts any associated running jobs first. Destructive — not exposed via MCP.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Responses

200

Default Response

application/json

successbooleanRequired

deletedCountnumberRequired

interruptedRunIdsstring · uuid[]Required

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/queues/{queue_id}/cases

HTTPcURLJavaScriptPython

DELETE /v1/queues/{queue_id}/cases HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "deletedCount": 1,
  "interruptedRunIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

post

Search cases in a queue with rich filters (multi-status, date ranges, label-based filters). Use this when the simple query-string filters on GET /v1/queues/:queue_id/cases aren't enough.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

limitinteger · min: 1 · max: 100OptionalDefault: 25

offsetinteger · max: 9007199254740991OptionalDefault: 0

sort_bystring · enumOptionalDefault: created_atPossible values:

sort_orderstring · enumOptionalDefault: descPossible values:

searchstringOptional

Responses

200

Default Response

application/json

totalnumberRequired

limitinteger · min: -9007199254740991 · max: 9007199254740991Required

offsetinteger · min: -9007199254740991 · max: 9007199254740991Required

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/search

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/search HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "filters": {
    "status": [
      "pending"
    ],
    "created_at_from": "text",
    "updated_at_from": "text",
    "labels": {
      "ANY_ADDITIONAL_PROPERTY": [
        "text"
      ]
    }
  },
  "limit": 25,
  "offset": 0,
  "sort_by": "created_at",
  "sort_order": "desc",
  "search": "text"
}

{
  "cases": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "queue_id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "data": "text",
      "status": "pending",
      "claimed_at": "text",
      "claimed_by_run_id": "text",
      "completed_at": "text",
      "postponed_to": "text",
      "created_at": "text",
      "updated_at": "text",
      "created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_by_user_name": "text",
      "created_by_user_email": "text",
      "agent_run_status": "text",
      "agent_run_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_human_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "pending_approval_approver_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "approval_approved_count": 1,
      "approval_rejected_count": 1,
      "search_match_data_snippet": {
        "before": "text",
        "match": "text",
        "after": "text"
      },
      "labels": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text",
          "color_hue": 1
        }
      ]
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

get

Get a case by ID. Returns the case and its event history.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

case_idstring · uuidRequired

The case'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})$

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/cases/{case_id}

HTTPcURLJavaScriptPython

GET /v1/cases/{case_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "case": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "queue_id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "text",
    "data": "text",
    "status": "pending",
    "claimed_at": "text",
    "claimed_by_run_id": "text",
    "completed_at": "text",
    "postponed_to": "text",
    "created_at": "text",
    "updated_at": "text",
    "created_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_by_user_name": "text",
    "created_by_user_email": "text",
    "agent_run_status": "text",
    "agent_run_user_id": "123e4567-e89b-12d3-a456-426614174000",
    "pending_human_request_id": "123e4567-e89b-12d3-a456-426614174000",
    "pending_approval_request_id": "123e4567-e89b-12d3-a456-426614174000",
    "pending_approval_approver_user_id": "123e4567-e89b-12d3-a456-426614174000",
    "approval_approved_count": 1,
    "approval_rejected_count": 1,
    "search_match_data_snippet": {
      "before": "text",
      "match": "text",
      "after": "text"
    },
    "labels": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "key": "text",
        "value": "text",
        "color_hue": 1
      }
    ]
  },
  "events": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "case_queue_item_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_run_id": "123e4567-e89b-12d3-a456-426614174000",
      "human_request_id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "created_at": "text",
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "text",
      "user_id": "123e4567-e89b-12d3-a456-426614174000",
      "user_name": "text",
      "user_email": "text",
      "human_request_title": "text"
    }
  ],
  "case_approval_requests": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_run_id": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "prompt": "text",
      "created_at": "text",
      "approver_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "approver_name": "text",
      "approver_email": "text",
      "decision": "approved",
      "resolved_at": "text",
      "resolved_by_user_id": "123e4567-e89b-12d3-a456-426614174000",
      "resolved_by_name": "text",
      "resolved_by_email": "text",
      "cancelled_at": "text",
      "cancellation_reason": "text"
    }
  ]
}

delete

Delete a case. Interrupts any associated running jobs first.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

case_idstring · uuidRequired

The case'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})$

Responses

200

Default Response

application/json

successbooleanRequired

interruptedRunIdsstring · uuid[]Required

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/cases/{case_id}

HTTPcURLJavaScriptPython

DELETE /v1/cases/{case_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "interruptedRunIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

get

List Jobs (agent runs) that have claimed or received handover of a case, newest first. Capped at 50 ownership events.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

case_idstring · uuidRequired

The case's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/cases/{case_id}/runs

HTTPcURLJavaScriptPython

GET /v1/cases/{case_id}/runs HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "runs": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "case_queue_item_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "text",
      "status": "not_started",
      "source": "text",
      "created_at": "text",
      "started_at": "text",
      "completed_at": "text",
      "claimed_at": "text",
      "has_pending_human_request": true,
      "pending_human_request_title": "text",
      "evaluation": {
        "passed": 1,
        "total": 1,
        "final_comment": "text",
        "status": "ready",
        "severityCounts": {
          "critical": 1,
          "medium": 1,
          "low": 1
        }
      },
      "user_id": "123e4567-e89b-12d3-a456-426614174000",
      "user_name": "text",
      "user_email": "text"
    }
  ]
}

get

Return the latest qualifying messages (assistant text + tool calls) for a Job on a case, newest last. Used to populate the live body of a running Job card in the case Activity timeline.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

case_idstring · uuidRequired

The case's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

run_idstring · uuidRequired

The agent run's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query parameters

limitinteger · min: 1 · max: 10Optional

Maximum number of qualifying messages to return. Defaults to 3, must be between 1 and 10.

Responses

200

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/cases/{case_id}/runs/{run_id}/recent-messages

HTTPcURLJavaScriptPython

GET /v1/cases/{case_id}/runs/{run_id}/recent-messages HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "messages": [
    {
      "id": "text",
      "type": "text",
      "runtime": "responses",
      "timestamp": "text",
      "raw_message": {
        "session_id": "text",
        "uuid": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "role": "assistant",
      "text_content": "text",
      "metadata": {
        "isAgentInstruction": true,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

post

Delegate multiple cases to a chosen agent, overriding the queue's default consumer. Any active runs on the selected cases are interrupted first; the cases are then reset to pending and assigned to the chosen agent for the next dispatcher tick. The chosen agent must already be connected to the queue as a case-queue-consumer (with the trigger enabled or disabled).

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

case_idsstring · uuid[] · min: 1 · max: 100Required

Case IDs to delegate (1-100).

agent_idstring · uuidRequired

The agent that should run on the selected cases. Must be a consumer of this queue.

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

Responses

200

Default Response

application/json

delegatedCountnumberRequired

skippedCountnumberRequired

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/bulk-delegate

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/bulk-delegate HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "case_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "agent_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "delegatedCount": 1,
  "skippedCount": 1
}

post

Delete multiple cases from a queue. Any active runs are interrupted first.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

case_idsstring · uuid[] · min: 1 · max: 100Required

Case IDs to delete (1-100).

Responses

200

Default Response

application/json

deletedCountnumberRequired

interruptedRunIdsstring · uuid[]Required

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/bulk-delete

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/bulk-delete HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "case_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "deletedCount": 1,
  "interruptedRunIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

post

Retry multiple cases by resetting them to pending. Any active runs are interrupted first. Cases already pending are skipped.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

case_idsstring · uuid[] · min: 1 · max: 100Required

Case IDs to retry (1-100).

Responses

200

Default Response

application/json

retriedCountnumberRequired

skippedCountnumberRequired

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/bulk-retry

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/bulk-retry HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "case_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "retriedCount": 1,
  "skippedCount": 1
}

post

Update the status of multiple cases to completed or failed. Interrupts any active runs and cancels pending human requests.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

case_idsstring · uuid[] · min: 1 · max: 100Required

Case IDs to update (1-100).

statusstring · enumRequired

Terminal status to set on each case.

Possible values:

Responses

200

Default Response

application/json

updatedCountnumberRequired

skippedCountnumberRequired

interruptedRunIdsstring · uuid[]Required

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/bulk-update-status

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/bulk-update-status HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "case_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "status": "completed"
}

{
  "updatedCount": 1,
  "skippedCount": 1,
  "interruptedRunIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

get

List all labels assigned to a case.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

case_idstring · uuidRequired

The case'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

limitinteger · min: 1 · max: 1000Optional

Maximum number of labels to return.

Default: 1000

offsetinteger · max: 9007199254740991Optional

Zero-based offset for pagination.

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/queues/{queue_id}/cases/{case_id}/labels

HTTPcURLJavaScriptPython

GET /v1/queues/{queue_id}/cases/{case_id}/labels HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "labels": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "key": "text",
      "value": "text",
      "color_hue": 1
    }
  ]
}

post

Assign one or more labels to a case. Creates the labels on the queue if they don't already exist.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

case_idstring · uuidRequired

The case'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})$

Body

application/json

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/{case_id}/labels

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/{case_id}/labels HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "labels": [
    {
      "key": "",
      "value": "text"
    }
  ]
}

{
  "labels": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "key": "text",
      "value": "text",
      "color_hue": 1
    }
  ]
}

get

List every label defined on a queue along with the count of cases each label is assigned to.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

limitinteger · min: 1 · max: 1000Optional

Maximum number of labels to return.

Default: 1000

offsetinteger · max: 9007199254740991Optional

Zero-based offset for pagination.

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/queues/{queue_id}/labels

HTTPcURLJavaScriptPython

GET /v1/queues/{queue_id}/labels HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "labels": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "key": "text",
      "value": "text",
      "color_hue": 1,
      "case_count": 1
    }
  ]
}

post

Create a label on a queue without assigning it to a case.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

Body

application/json

keystringOptionalDefault: ""

valuestring · min: 1Required

color_hueinteger · max: 360Optional

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/labels

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/labels HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "key": "",
  "value": "text",
  "color_hue": 1
}

{
  "label": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "key": "text",
    "value": "text",
    "color_hue": 1,
    "case_count": 1
  }
}

post

Remove the given labels from a case.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

case_idstring · uuidRequired

The case'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})$

Body

application/json

label_idsstring · uuid[] · min: 1Required

Responses

200

Default Response

application/json

successbooleanRequired

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

post

/v1/queues/{queue_id}/cases/{case_id}/labels/unlink

HTTPcURLJavaScriptPython

POST /v1/queues/{queue_id}/cases/{case_id}/labels/unlink HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "label_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "success": true
}

delete

Delete a label from a queue. Cascade-deletes all assignments of this label on existing cases.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

label_idstring · uuidRequired

The label'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})$

Responses

200

Default Response

application/json

successbooleanRequired

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/queues/{queue_id}/labels/{label_id}

HTTPcURLJavaScriptPython

DELETE /v1/queues/{queue_id}/labels/{label_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

patch

Update a label's key, value, or color. Renaming key/value affects every case assigned to this label.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Path parameters

queue_idstring · uuidRequired

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

label_idstring · uuidRequired

The label'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})$

Body

application/json

keystringOptional

valuestring · min: 1Required

color_hueinteger · max: 360Optional

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

409

Default Response

application/json

500

Default Response

application/json

patch

/v1/queues/{queue_id}/labels/{label_id}

HTTPcURLJavaScriptPython

PATCH /v1/queues/{queue_id}/labels/{label_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "key": "text",
  "value": "text",
  "color_hue": 1
}

{
  "label": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "key": "text",
    "value": "text",
    "color_hue": 1
  }
}