Tags
| Tool | REST endpoint | Annotations |
|---|
list_tags | GET /v1/tags | read-only, idempotent |
create_tag | POST /v1/tags | write |
update_tag | PATCH /v1/tags/{tagId} | write |
delete_tag | DELETE /v1/tags/{tagId} | destructive |
No arguments. Returns the workspace's tags, grouped.
create_tag
| Field | Type | Required | Description |
|---|
name | string (1-100) | yes | Visible, unique name. Immutable after creation. |
criteria | string (≤ 500) | no | Natural-language criterion used by the AI when automatic = true. |
automatic | boolean | no | Whether it's applied automatically. Default false. |
owners | string[] (emails) | no | |
workspace | string | if multi-ws | |
update_tag
Lets you update criteria, automatic, and owners. The name cannot be changed.
| Field | Required |
|---|
tagId | yes |
workspace | if multi-ws |
criteria, automatic, owners | at least one |
delete_tag
| Field | Required |
|---|
tagId | yes |
workspace | if multi-ws |