Skip to content
LogoLogo

Create a Project-local task-label definition

Create a Project-local task-label definition

POST/api/v1/projects/{project_id}/label-definitions

Path Parameters

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

Header Parameters

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
purposeRequired
string
Values
documentprojecttask
scopeRequired
string
Values
workspaceproject
nameRequired
string·min 1·max 80
colorRequired
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

Responses