4 routes
/tags
4 routes.
GET /v1/tags
List tags
Scopes — tags:read
Query
| parameter | type | limit | |
|---|---|---|---|
limit |
integer | optional | max 200 |
cursor |
string | optional | max 4096 chars |
updated_since |
string | optional | max 24 chars |
Errors — unauthorized · rate_limited
POST /v1/tags
Create a tag, or return the existing one
Scopes — tags:write
Request body
| field | type | limit | |
|---|---|---|---|
name |
string | required | max 64 chars, min 1 |
colorHex |
string | optional | max 16 chars, — |
Errors — unauthorized · rate_limited
PATCH /v1/tags/{id}
Change a tag colour (renaming is refused)
Scopes — tags:write
Request body
| field | type | limit | |
|---|---|---|---|
colorHex |
string | required | max 16 chars, — |
Errors — validation_failed · unauthorized · rate_limited
DELETE /v1/tags/{id}
Delete a tag and remove it from every to-do
Scopes — tags:write
Errors — unauthorized · rate_limited