Sign inGet Started

Update a label

PATCH
/v1/labels/{label_id}
const label = await bird.labels.update("lbl_01krdgeqcxet5s7t44vh8rt9mg", {
  name: "refund",
  color: null,
});
console.log(label.name);
Respons200
{
  "id": "lbl_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Hot lead",
  "color": "#E5484D",
  "description": "Inbound sales enquiry from a company. Not support requests or vendors.",
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Renames a label, or changes or removes its colour or description. Omitted fields are left unchanged, and the label keeps its ID. The new name must not already be in use in the workspace, regardless of case.

Parameter

label_idstring

The catalogue label to act on.

Payload Permintaan

name
string

The label name, unique in the workspace regardless of case. No commas, control characters, or leading or trailing whitespace. System names such as inbox, sent, unread, open or assigned are reserved.

color
nullable string

The new colour, or null to remove it.

description
nullable string

The new description, or null to remove it.

Payload Respons

id
string
wajib

ID of the label, accepted by every operation that takes a label_id. It stays the same when the label is renamed.

name
string
wajib

The label name, unique in the workspace regardless of case. No commas, control characters, or leading or trailing whitespace. System names such as inbox, sent, unread, open or assigned are reserved.

color
nullable string
wajib

The label colour as a #RRGGBB hex value, or null when none is set.

description
nullable string
wajib

When to apply the label, or null when none is set.

created_at
string
wajib
updated_at
string
wajib

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.