Get Next Annotation Queue Item — API

Retrieve the next available queue item for the current user to annotate. Returns item ID, source type, status, and assignment info.

GET https://api.futureagi.com/model-hub/annotation-queues/{queue_id}/items/next-item/

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

Query parameters

exclude string Optional

Comma-separated list of item UUIDs to skip when selecting the next item.

before UUID Optional

When provided, returns the item immediately before this item ID in queue order (for backwards navigation).

Response

200 OK
item object
The next available queue item, or null if no items are available. Contains the full QueueItem object fields.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Resource not found.

500 Internal Server Error Optional

Unexpected server error.

Note

Items already in progress by the current user are returned first. If none exist, a new pending item is assigned based on the queue’s assignment strategy.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE