> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tylon.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Labels

> Read and write the labels on a Tylon board.

Labels are the board's own, shared across its projects.

## Reading them

<ParamField path="GET /v1/labels" type="endpoint" />

Every label on the board, with the id a card is patched with.

```json theme={null}
[
  { "id": "85098258082431403", "name": "api", "color": "blue", "taskCount": 10 }
]
```

`labelIds` on [`PATCH /v1/cards/{number}`](/en/api-reference/endpoints/cards)
is the whole set, so this is where the set comes from.

## Writing them

Member, except deleting.

<ParamField path="POST /v1/labels" type="endpoint" />

<ParamField body="name" type="string" required />

<ParamField body="color" type="string">
  One of the palette's names, not a hex value.
</ParamField>

```json theme={null}
{
  "id": "84842099970805746",
  "name": "needs-migration",
  "color": "amber",
  "taskCount": 0
}
```

<ParamField path="PATCH /v1/labels/{labelId}" type="endpoint" />

<ParamField path="DELETE /v1/labels/{labelId}" type="endpoint" />

Deleting takes the label off every card at once. `taskCount` is how many that
would be — which is why it takes **maintainer**, the same as on screen.