Update a label

patch

https://api.lingohub.com/v2/labels/{labelId}

Partially updates the label identified by the given ID (JSON merge-patch). Only fields present in the request body are changed; omitted fields are left unchanged and a null ai_context clears it. Returns the full updated label. Requires workspace-level label management permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

labelId

string

required

^la_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Unique identifier of the label.

Body Params

Request body to partially update a label (PATCH, JSON merge-patch). Omitted fields are left unchanged. ai_context may be set to null to clear it; name and color cannot be null.

name

string

length between 2 and 255

Display name of the label. Must be unique within the workspace (case-insensitive).

color

string

#[0-9a-fA-F]{6}

Hex color code of the label (e.g., #FF5733).

ai_context

string | null

Context describing the label's meaning to AI features (e.g., LINA translation agents).

Headers

If-Match

string

Optional precondition. Send the quoted ETag from a GET of this resource. The mutation only runs if a strong tag matches the current representation, checked under the write lock. A comma-separated list is allowed; '*' requires an existing representation. Weak tags never match. Omit this header for an unconditional write. For an action, use the ETag from GET of the target resource, without the action suffix. A stale tag returns 412; read the current state before retrying.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Label updated successfully.

400The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. code names the problem, errors the parameter or field.

401Invalid or missing API key.

403Insufficient permissions.

404Label not found.

409A label with this name already exists (already_exists on name).

412The current representation does not match If-Match (precondition_failed). No change was applied.

422Validation error.

429The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.

500An unexpected internal server error occurred.

503The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.