Labels

Update Label

Update a personal label.

At least one mutable field must be provided. Passing null for an optional field keeps the existing value unchanged.

post/api/v1/labels/{label_id}

Path parameters

label_idinteger required

String ID of the label

namestring nullable

Updated label name. Passing null or omitting this field will leave it unchanged.

orderinteger nullable

Position of the label in the label list. Passing null or omitting this field will leave it unchanged.

is_favoriteboolean nullable

Whether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged.

{
  "name": "Priority",
  "order": 12,
  "is_favorite": true
}

Successful Response

idstring required

String ID of the label.

namestring required

Label name.

colorstring required

Label color name.

orderinteger nullable required

Position of the label in the label list, or null when no explicit order is set.

is_favoriteboolean required

Whether the label is marked as a favorite.

{
  "id": "2147509004",
  "name": "Priority",
  "color": "berry_red",
  "order": 12
}

No recorded changes to this endpoint across all 10 revisions of this API.