Annotation Queues

import { listAnnotationQueues } from "@arizeai/ax-client";

const { data: queues, pagination } = await listAnnotationQueues({
  space: "my-space",  // space name or ID (optional)
  name: "quality",    // substring filter on queue name (optional)
  limit: 10,
});

import { createAnnotationQueue } from "@arizeai/ax-client";

const queue = await createAnnotationQueue({
  name: "Quality Review Queue",
  spaceId: "your_space_id",  // raw space ID required
  annotationConfigIds: ["your_annotation_config_id"],
  annotatorEmails: ["reviewer@example.com"],
  assignmentMethod: "ALL",  // "ALL" or "RANDOM" (optional, defaults to "ALL")
  instructions: "Review each span for accuracy and relevance.",  // optional
});

import { getAnnotationQueue } from "@arizeai/ax-client";

// By ID
const queue = await getAnnotationQueue({ annotationQueue: "your_queue_id" });

// By name (requires space)
const queue = await getAnnotationQueue({
  annotationQueue: "Quality Review Queue",
  space: "my-space",
});

import { updateAnnotationQueue } from "@arizeai/ax-client";

const queue = await updateAnnotationQueue({
  annotationQueue: "Quality Review Queue",  // queue name or ID
  space: "my-space",                        // required when using a name
  name: "Updated Queue Name",               // optional
  annotatorEmails: ["reviewer@example.com", "lead@example.com"],  // replaces all existing
});

import { deleteAnnotationQueue } from "@arizeai/ax-client";

await deleteAnnotationQueue({
  annotationQueue: "Quality Review Queue",  // queue name or ID
  space: "my-space",                        // required when using a name
});

import { listAnnotationQueueRecords } from "@arizeai/ax-client";

const { data: records, pagination } = await listAnnotationQueueRecords({
  annotationQueue: "your_queue_id",
  limit: 20,
});

import { addAnnotationQueueRecords } from "@arizeai/ax-client";

const records = await addAnnotationQueueRecords({
  annotationQueue: "your_queue_id",
  recordSources: [
    {
      recordType: "SPAN",
      projectId: "your_project_id",
      startTime: "2026-03-01T00:00:00Z",
      endTime: "2026-03-08T00:00:00Z",
      spanIds: ["your_span_id"],
    },
  ],
});

import { annotateAnnotationQueueRecord } from "@arizeai/ax-client";

const result = await annotateAnnotationQueueRecord({
  annotationQueue: "your_queue_id",
  annotationQueueRecordId: "your_record_id",
  annotations: [
    { name: "accuracy", label: "correct", score: 1.0 },
    { name: "quality", text: "Well-structured response" },
  ],
});

import { assignAnnotationQueueRecord } from "@arizeai/ax-client";

const result = await assignAnnotationQueueRecord({
  annotationQueue: "your_queue_id",
  annotationQueueRecordId: "your_record_id",
  assignedUserEmails: ["reviewer@example.com"],
});

import { deleteAnnotationQueueRecords } from "@arizeai/ax-client";

await deleteAnnotationQueueRecords({
  annotationQueue: "your_queue_id",
  recordIds: ["your_record_id_1", "your_record_id_2"],
});