Create Annotation Label — API

Create a new annotation label with a name, type (star, binary, categorical), description, settings, and optional notes. Returns the created label object.

POST https://api.futureagi.com/model-hub/annotations-labels/

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

Display name for the label. Must be unique within your organization.

type string Required

The label type. One of text, categorical, numeric, star, or thumbs_up_down. This cannot be changed after creation.

description string Optional

Optional description of what this label measures.

settings object Optional

Type-specific configuration (e.g. {"no_of_stars": 5} for star labels).

project UUID Optional

Project UUID to scope this label to a specific project.

allow_notes boolean Optional

Whether annotators can add free-text notes when using this label (default: false).

Response

200 OK
result string
Confirmation message: "Annotation label created successfully".

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