Update Label

Update an existing annotation label.

Update Label

Update an existing annotation label. You can change the name, description, and settings, but the label type cannot be changed after creation.

PUT https://api.futureagi.com/model-hub/annotations-labels/{id}/
Bearer 
          Click "Try It" to send a request

Authentication

All requests require authentication via API keys:

HeaderDescription
X-Api-KeyYour API key
X-Secret-KeyYour secret key

Path Parameters

id string Required

UUID of the annotation label to update.

Request Body

name string

Updated display name for the label.

description string

Updated description.

settings object

Updated type-specific settings. The structure must match the label’s type (see Create Label for settings reference).

Note

The label type cannot be changed after creation. If you need a different type, create a new label.

Response

Returns the updated Label object:

id string
UUID of the label.
name string
Updated display name.
type string
Label type (unchanged).
description string
Updated description.
settings object
Updated type-specific settings.
created_at string
ISO 8601 timestamp of creation.
updated_at string
ISO 8601 timestamp of last update.

Code Examples

import requests

label_id = "your-label-uuid"
url = f"https://api.futureagi.com/model-hub/annotations-labels/{label_id}/"
headers = {
    "X-Api-Key": "YOUR_API_KEY",
    "X-Secret-Key": "YOUR_SECRET_KEY",
    "Content-Type": "application/json",
}

payload = {
    "name": "Updated Label Name",
    "description": "Updated description for this label",
    "settings": {"no_of_stars": 10},
}

response = requests.put(url, json=payload, headers=headers)
print(response.json())
const labelId = "your-label-uuid";

const response = await fetch(
  `https://api.futureagi.com/model-hub/annotations-labels/${labelId}/`,
  {
    method: "PUT",
    headers: {
      "X-Api-Key": "YOUR_API_KEY",
      "X-Secret-Key": "YOUR_SECRET_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Updated Label Name",
      description: "Updated description for this label",
      settings: { noOfStars: 10 },
    }),
  }
);

const label = await response.json();
console.log(label);
curl -X PUT "https://api.futureagi.com/model-hub/annotations-labels/your-label-uuid/" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "X-Secret-Key: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Label Name",
    "description": "Updated description for this label",
    "settings": {"no_of_stars": 10}
  }'
Was this page helpful?

Questions & Discussion