Submit Item Annotations — API

Submit label scores and reviewer notes for an annotation queue item. Accepts queue UUID, item UUID, an array of annotation values, and optional notes.

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

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

item_id UUID Required

The queue item ID

Request body

annotations array of objects Required

Array of annotation objects.

label_id UUID Required

The annotation label ID.

value any Required

The annotation value (type depends on the label).

notes string Optional

Free-text notes for this item.

Response

200 OK
submitted integer
Number of annotation scores that were created or updated.

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