REST API
Tags
Read-only listing of the organization's tag registry.
Tags are the org-managed labels attached to tasks (e.g. backend, design, urgent). They appear on the Task read shape as tags: [{ tag }], and are written via the tagIds array on POST / PATCH /api/v1/tasks. The registry is exposed read-only — manage entries from Organization Settings → Tasks → Tags.
Endpoints
| Method | Path | Notes |
|---|---|---|
GET | /api/v1/tags | List tags alphabetical by name. Offset pagination. |
Tag model
{
"id": "tg1…",
"organizationId": "...",
"name": "backend",
"color": "#0ea5e9",
"createdAt": "...",
"updatedAt": "..."
}Listing tags
GET /api/v1/tags?limit=50&offset=0| Param | Type | Default | Range |
|---|---|---|---|
limit | int | 50 | 1–100 |
offset | int | 0 | ≥ 0 |
Returns { data, total }.