Tags & Comments API
Categorize tasks with custom organization-level tags and collaborate through threaded task comments.
List Workspace TagsAuth
Retrieve all tags defined in the active organization workspace.
Status Codes
- Name
200- Type
- HTTP
- Description
- List of tags.
Request
GET/api/v1/tags
Response 200
Create TagAuth
Create a new tag with a custom color code.
Payload Example
{
"name": "infrastructure",
"color": "#10b981"
}Status Codes
- Name
201- Type
- HTTP
- Description
- Tag created.
- Name
400- Type
- HTTP
- Description
- Tag already exists in workspace.
- Name
name- Type
- string
- Required
- Description
- Tag label name.
- Name
color- Type
- string
- Required
- Description
- Hex color code (e.g.
#10b981).
Request
POST/api/v1/tags
Response 201
List Task CommentsAuth
Fetch all threaded discussion comments for a task.
Status Codes
- Name
200- Type
- HTTP
- Description
- Comments list.
- Name
404- Type
- HTTP
- Description
- Task not found.
Request
GET/api/v1/tasks/{id}/comments
Response 200
Add Comment to TaskAuth
Add a collaboration note or execution update to a task.
Payload Example
{
"content": "Verified WAL mode auto-checkpointing under 100 concurrent writes."
}Status Codes
- Name
201- Type
- HTTP
- Description
- Comment added.
- Name
content- Type
- string
- Required
- Description
- Comment text in markdown format.
Request
POST/api/v1/tasks/{id}/comments
Response 201