Case Queues

Manage case queues and their agent bindings

get

List case queues for your team.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Query parameters

limitinteger · min: 1 · max: 250Optional

Number of queues per page (1-250, default 250)

Default: 250

offsetinteger · max: 9007199254740991Optional

Number of queues to skip

Responses

200

Default Response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Default Response

application/json

401

Default Response

application/json

500

Default Response

application/json

get

/v1/queues

HTTPcURLJavaScriptPython

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

{
  "queues": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "folder_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "text",
      "has_approvals": true
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

post

Create a new case queue.

Authorizations

bearerAuth

AuthorizationstringRequired

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

Body

application/json

namestring · min: 1 · max: 100Required

Queue name. Must be unique within the team.

descriptionstring · max: 500 · nullableOptional

Optional human-readable description.

folder_idstring · uuid · nullableOptional

Optional folder to nest the queue under.

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

201

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

500

Default Response

application/json

post

/v1/queues

HTTPcURLJavaScriptPython

POST /v1/queues HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "name": "text",
  "description": "text",
  "folder_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "queue": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "folder_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "text",
    "has_approvals": true
  }
}

get

Get a case queue by ID.

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

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}

HTTPcURLJavaScriptPython

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

{
  "queue": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "folder_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "text",
    "has_approvals": true
  }
}

delete

Delete a case queue. Interrupts all associated running jobs first and returns the number of deleted cases plus the IDs of runs that were stopped.

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

deleted_case_countnumberRequired

interrupted_run_idsstring · uuid[]Required

400

Default Response

application/json

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}

HTTPcURLJavaScriptPython

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

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

patch

Update a case 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

namestring · min: 1 · max: 100Optional

New queue name. Must be unique within the team.

descriptionstring · max: 500 · nullableOptional

New description, or null to clear.

folder_idstring · uuid · nullableOptional

New folder id, or null to move to the root.

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

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

patch

/v1/queues/{queue_id}

HTTPcURLJavaScriptPython

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

{
  "name": "text",
  "description": "text",
  "folder_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "queue": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "folder_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "text",
    "has_approvals": true
  }
}

get

List agents bound to a queue as producers (agents that push cases into the queue) or consumers (agents triggered by cases in 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})$

Responses

200

Default Response

application/json

queue_namestringRequired

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}/agents

HTTPcURLJavaScriptPython

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

{
  "queue_name": "text",
  "producers": [
    {
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "text",
      "case_trigger_enabled": true,
      "case_trigger_queue_name": "text",
      "problems": [
        "multiple_triggers"
      ]
    }
  ],
  "consumers": [
    {
      "agent_id": "123e4567-e89b-12d3-a456-426614174000",
      "agent_name": "text",
      "case_trigger_enabled": true,
      "is_handover_target": true,
      "problems": [
        "multiple_triggers"
      ]
    }
  ]
}