Create Queue

Create a new annotation queue with assignment strategy and configuration.

POST https://api.futureagi.com/model-hub/annotation-queues/

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.

Request body

name string Required

Queue name

description string Optional

Queue description

instructions string Optional

Instructions for annotators

status string Optional

Initial status: draft (default), active, paused

assignment_strategy string Optional

manual, round_robin (default), or load_balanced

annotations_required integer Optional

Number of annotations required per item (default: 1)

reservation_timeout_minutes integer Optional

Minutes before a reserved item is released (default: 30)

requires_review boolean Optional

Whether completed items require review (default: false)

auto_assign boolean Optional

Automatically assign all new items to all queue members (default: false).

project_id UUID Optional

Associate this queue with a project.

dataset_id UUID Optional

Associate this queue with a dataset.

agent_definition_id UUID Optional

Associate this queue with an agent definition.

label_ids array Optional

List of annotation label UUIDs to attach

annotator_ids array Optional

List of user UUIDs to assign as annotators

annotator_roles object Optional

Map of user UUID → role (annotator, manager, reviewer) to set per annotator.

Response

201 Created
id string
UUID of the created queue.
name string
Queue name.
description string
Queue description.
instructions string
Annotator instructions.
status string
Queue status (active, paused, completed).
assignment_strategy string
Assignment strategy: manual, round_robin, or load_balanced.
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
Attached labels (nested objects with id, label_id, name, type, required, order).
annotators array
Queue members (nested objects with id, user_id, name, email, role).
created_by string
UUID of the user who created the queue.
created_by_name string
Name of the creator.
created_at string
ISO 8601 creation timestamp.

Errors

400 Bad Request Optional

Invalid request parameters.

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE