Skip to main content

Complete an annotation queue item

POST 
/api/v1/evals/complete-annotation-queue-item

Marks an annotation queue item completed. The immediate response can contain completedBy, but the current API does not persist that attribution for later list reads. Do not use this response alone as a durable reviewer audit record.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Review and score turns

Request​

Responses​

OK

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-IS-evaluation-api-completeAnnotationQueueItem#example-evals-completeAnnotationQueueItem-request

Request example

{
  "queueId": "example_123",
  "itemId": "example_123"
}

Guide request for 4. Complete the saved review. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-completeAnnotationQueueItem#example-cookbook-insights-evaluation-review-07-request

Request example

{
  "queueId": "q_weekly",
  "itemId": "qi_001"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-IS-evaluation-api-completeAnnotationQueueItem#example-evals-completeAnnotationQueueItem-response

Response example

{
  "item": {
    "itemId": "example_123",
    "queueId": "example_123",
    "objectId": "example_123",
    "objectType": "EVAL_TARGET_TYPE_TRACE",
    "status": "ANNOTATION_QUEUE_ITEM_STATUS_PENDING",
    "completedAt": "2026-09-16T12:00:00Z",
    "completedBy": "example",
    "createdAt": "2026-09-16T12:00:00Z"
  }
}

Illustrative response for 4. Complete the saved review. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-IS-evaluation-api-completeAnnotationQueueItem#example-cookbook-insights-evaluation-review-json-02-response

Response example

{
  "item": {
    "itemId": "qi_001",
    "queueId": "q_weekly",
    "status": "ANNOTATION_QUEUE_ITEM_STATUS_COMPLETED",
    "completedAt": "2026-08-12T17:14:22Z",
    "completedBy": "reviewer_9"
  }
}

Document ID: DOC-IS-evaluation-api-completeAnnotationQueueItem. Section identities and revisions.

SectionStable reference
Complete an annotation queue itemDOC-IS-evaluation-api-completeAnnotationQueueItem#overview
RequestDOC-IS-evaluation-api-completeAnnotationQueueItem#request
ResponsesDOC-IS-evaluation-api-completeAnnotationQueueItem#responses