Update Annotation Queue — API

Update an annotation queue's name, description, instructions, assignment strategy, or review settings by UUID. Returns the updated queue configuration.

PUT https://api.futureagi.com/model-hub/annotation-queues/{id}/

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

id UUID Required

The annotation queue ID

Request body

name string Optional

Queue name

description string Optional

Queue description

instructions string Optional

Instructions for annotators

assignment_strategy string Optional

manual, round_robin, or load_balanced

annotations_required integer Optional

Annotations required per item

reservation_timeout_minutes integer Optional

Reservation timeout in minutes

requires_review boolean Optional

Whether review is required

auto_assign boolean Optional

Whether to automatically assign new items to all queue members.

label_ids array Optional

Label UUIDs to attach (replaces existing labels).

annotator_ids array Optional

Annotator user UUIDs (replaces existing annotators).

annotator_roles object Optional

Map of user UUID → role to update per annotator.

Response

200 OK
id string
UUID of the queue.
name string
Updated queue name.
description string
Updated description.
instructions string
Updated annotator instructions.
status string
Current queue status.
assignment_strategy string
Assignment strategy.
annotations_required integer
Annotations required per item.
reservation_timeout_minutes integer
Reservation timeout.
requires_review boolean
Whether review is required.
auto_assign boolean
Whether auto-assign is enabled.
organization string
Organization UUID.
project string
Associated project UUID or null.
dataset string
Associated dataset UUID or null.
agent_definition string
Associated agent definition UUID or null.
is_default boolean
Whether this is a default queue.
labels array
Updated label list.
annotators array
Updated annotator list.
created_by string
Creator UUID.
created_by_name string
Creator name.
created_at string
ISO 8601 creation timestamp.

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