Assign Queue Items to Annotator — API

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

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.

queue_id UUID Required

The annotation queue ID

item_ids array Required

List of queue item UUIDs to assign

user_ids array Optional

List of user UUIDs to assign items to. Supports multi-annotator assignment.

user_id UUID Optional

Single user UUID (legacy). If provided without user_ids, treated as user_ids=[user_id] with action=set.

action string Optional

Assignment action: add (add users to existing assignments), set (replace all assignments), or remove (remove listed users). Defaults to add.

200 OK

assigned integer

Number of item-user assignment pairs created or modified.

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.