Skip to content
LogoLogo

Rename, recolor, or restore a label definition

Rename, recolor, or restore a label definition

PATCH/api/v1/label-definitions/{label_id}

Path Parameters

label_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

If-MatchRequired
string

Entity tag containing the resource version last observed by the client.

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Request Body

application/json
name
string·min 1·max 80
color
string·max 11

Shared user-chosen color: a Tailwind color family name, optionally pinned to one Tailwind step (for example amber or amber-400). A bare name lets each client choose the shade for its surface; a pinned step renders that exact shade.

Exampleindigo
archived
boolean

Send false to restore an archived definition. Omit for rename/recolor.

Responses