Add Items to Annotation Queue — API

Add one or more source items (traces, spans) to an annotation queue in bulk. Accepts queue UUID and an array of source type and source ID pairs.

POST https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/add-items/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Path parameters

queue_id UUID Required

The annotation queue ID

Request body

items array of objects Required

Array of items to add.

source_type string Required

Type of source: trace, observation_span, dataset_row, trace_session, or call_execution.

source_id UUID Required

UUID of the source object.

Response

200 OK
added integer
Number of items successfully added.
duplicates integer
Number of items skipped because they were already in the queue.
errors array
List of error messages for items that could not be added.
queue_status string
Current status of the queue after the operation.

Errors

400 Bad Request Optional

Invalid request parameters.

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Resource not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE