Find Queues for Source — API

Find all annotation queues containing a specific source item. Accepts source type, source UUID, or a JSON array of sources for multi-source lookup.

GET https://api.futureagi.com/model-hub/annotation-queues/for-source/

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.

Query parameters

source_type string Optional

The type of source (e.g. trace, observation_span, dataset_row). Required if sources is not provided.

source_id UUID Optional

The source object’s UUID. Required if sources is not provided.

sources string Optional

JSON-encoded array of source objects for multi-source lookup. Each entry must have source_type and source_id. Example: [{"source_type":"trace","source_id":"uuid"}]. Use this instead of source_type/source_id for batch queries.

Response

200 OK

An array of queue entries the current user can annotate. Each entry has:

queue object
Queue summary with id, name, instructions, is_default.
item object
The queue item for this source, or null if none exists. Contains id, status, source_type.
labels array
Labels attached to the queue.
existing_scores object
Map of label UUID → current user’s annotation value for this source.
existing_notes string
Current user’s existing note for this source.
existing_label_notes object
Map of label UUID → per-label note text.
span_notes array
All span notes for observation_span sources. Each has id, notes, annotator, created_at.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE