List Annotation Labels — API

List annotation labels with optional filters for type, name search, project, dataset scope, and usage count. Returns a paginated array of label objects.

GET 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.

Query parameters

type string Optional

Filter by label type

search string Optional

Search labels by name

project_id UUID Optional

Filter labels belonging to a specific project

dataset UUID Optional

Filter labels that are valid for a specific dataset

include_usage_count boolean Optional

When true, each label includes trace_annotations_count and annotation_count

page number Optional

Page number (default: 1)

page_size number Optional

Results per page (default: 20)

Response

200 OK
count integer
Total number of matching labels.
next string
URL for the next page, or null.
previous string
URL for the previous page, or null.
results array
Array of Label objects. Each contains: id, name, type, organization, project, description, settings, allow_notes, created_at. When include_usage_count=true, also includes trace_annotations_count and annotation_count.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE