Skip to main content
GET
/
v2
/
annotation-queues
List annotation queues
curl --request GET \
  --url https://api.arize.com/v2/annotation-queues \
  --header 'Authorization: Bearer <token>'
{
  "annotation_queues": [
    {
      "id": "aq_abc123",
      "name": "Quality Review Queue",
      "space_id": "spc_xyz789",
      "instructions": "Review each response for accuracy and helpfulness",
      "annotation_configs": [
        {
          "id": "ac_001",
          "name": "accuracy",
          "type": "continuous",
          "space_id": "spc_xyz789",
          "minimum_score": 0,
          "maximum_score": 10,
          "optimization_direction": "maximize",
          "created_at": "2024-01-10T08:00:00Z"
        }
      ],
      "annotators": [
        {
          "id": "usr_001",
          "email": "reviewer@example.com"
        }
      ],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:45:00Z"
    },
    {
      "id": "aq_def456",
      "name": "Safety Evaluation Queue",
      "space_id": "spc_xyz789",
      "instructions": null,
      "annotation_configs": [],
      "annotators": [],
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-10T08:00:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Query Parameters

space_id
string

Filter search results to a particular space ID A universally unique identifier

Example:

"RW50aXR5OjEyMzQ1"

space_name
string

Case-insensitive substring filter on the space name. Narrows results to resources in spaces whose name contains the given string. If omitted, no space name filtering is applied and all resources are returned.

Maximum string length: 255
name
string

Case-insensitive substring filter on the resource name. Returns only resources whose name contains the given string. For example, name=prod matches "production", "my-prod-dataset", etc. If omitted, no name filtering is applied and all resources are returned.

Maximum string length: 255
limit
integer
default:50

Maximum items to return

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Response

Returns a list of annotation queue objects

annotation_queues
object[]
required

A list of annotation queues

pagination
object
required

Pagination metadata for cursor-based navigation