> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.coperniq.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.coperniq.io/_mcp/server.

## Labels — list and create

Manage labels that can be applied to work orders and assets.

### Endpoints

| Method | Path                | Description                                            |
| ------ | ------------------- | ------------------------------------------------------ |
| `GET`  | `/labels`           | List all active labels (paginated, filterable by type) |
| `POST` | `/labels`           | Create a label                                         |
| `GET`  | `/labels/{labelId}` | Get a label by ID                                      |

#### Query parameters (`GET /labels`)

| Parameter   | Type              | Default | Description                                     |
| ----------- | ----------------- | ------- | ----------------------------------------------- |
| `type`      | `WORK` \| `ASSET` | —       | Filter by label type. Omit to return all types. |
| `page`      | `integer`         | `1`     | Page number (1-based, max 1000)                 |
| `page_size` | `integer`         | `20`    | Results per page (max 100)                      |

#### Create a label

```
POST /labels
```

```json
{
  "name": "Urgent",
  "color": "#FF5733",
  "type": "WORK"
}
```

* `name` — required, non-empty string.
* `type` — required; `WORK` applies the label to work orders, `ASSET` to assets. Note: the public API uses `WORK` where the internal system uses `TASK`.
* `color` — optional hex color code; pass `null` to create a label with no color.

#### Label object

```json
{
  "id": 101,
  "name": "Urgent",
  "color": "#FF5733",
  "type": "WORK",
  "createdAt": "2026-04-30T00:00:00.000Z",
  "updatedAt": "2026-04-30T00:00:00.000Z"
}
```