/
Tasks
Create, update, and manage tasks within your projects. Tasks support statuses, priorities, assignees, dates, and story point estimates.
Endpoints
List tasks in your workspace
Parameters
projectIdstringFilter by project (query param)statusstringFilter by status (see values below)limitnumberNumber of tasks (max 100, default 50)offsetnumberPagination offset (default 0)Response
{
"tasks": [
{
"id": "tsk_abc123",
"taskNumber": 42,
"title": "Implement dark mode",
"status": "in_progress",
"priority": "high",
"startDate": 1709251200000,
"dueDate": 1709856000000,
"completedAt": null,
"estimatePoints": 5,
"createdAt": "2024-03-01T00:00:00Z",
"updatedAt": "2024-03-01T12:00:00Z",
"creator": {
"id": "usr_abc789",
"name": "John Doe",
"image": "/api/media/avatars/john.jpg"
},
"assignee": {
"id": "usr_def456",
"name": "Jane Smith",
"image": "/api/media/avatars/jane.jpg"
},
"project": {
"id": "prj_xyz789",
"name": "Product Launch",
"color": "#3B82F6"
}
}
],
"total": 42,
"hasMore": true
}Create a new task
Parameters
titlestringrequiredTask title (max 500 chars)projectIdstringrequiredProject to create the task indescriptionTextstringPlain text descriptiondescriptionobjectRich text description (JSON)statusstringTask status (default: todo)prioritystringTask priority (default: none)assigneeIdstringUser ID to assign the task tostartDatenumberStart date (Unix ms timestamp)dueDatenumberDue date (Unix ms timestamp)estimatePointsnumberStory point estimateGet a single task by ID
Parameters
idstringrequiredTask ID (URL path)Update an existing task
Parameters
idstringrequiredTask ID (URL path)titlestringNew titledescriptionTextstringNew plain text descriptiondescriptionobjectNew rich text description (JSON)statusstringNew statusprioritystringNew priorityassigneeIdstringNew assignee user IDstartDatenumberNew start date (Unix ms timestamp)dueDatenumberNew due date (Unix ms timestamp)estimatePointsnumberNew story point estimateList comments on a task
Parameters
idstringrequiredTask ID (URL path)limitnumberNumber of comments (max 100, default 50)offsetnumberPagination offset (default 0)Add a comment to a task
Parameters
idstringrequiredTask ID (URL path)contentstringrequiredComment text (max 10,000 chars)Edit a task comment (author only)
Parameters
idstringrequiredTask ID (URL path)commentIdstringrequiredComment ID (URL path)contentstringrequiredNew comment text (max 10,000 chars)Delete a single task comment
Parameters
idstringrequiredTask ID (URL path)commentIdstringrequiredComment ID (URL path)Delete all comments on a task
Parameters
idstringrequiredTask ID (URL path)Link a task to a post
Parameters
idstringrequiredTask ID (URL path)postIdstringrequiredPost ID to linkRemove all post links from a task
Parameters
idstringrequiredTask ID (URL path)Task Status
backlogNot yet planned.todoPlanned and ready to be worked on. Default status for new tasks.in_progressCurrently being worked on.in_reviewWork complete, awaiting review.doneCompleted and verified.cancelledCancelled and will not be completed.Task Priority
noneNo priority set. Default for new tasks.lowLow priority.mediumMedium priority.highHigh priority.urgentUrgent — needs immediate attention.Dates
The startDate and dueDate fields accept Unix timestamps in milliseconds. Both fields are optional and can be set independently.
Pagination
The list tasks endpoint supports offset-based pagination. Use the offset and limit query parameters to paginate through results. The response includes a total count and hasMore flag.
Task Links
Tasks can be linked to posts using the links endpoints. This creates a bidirectional relationship between a task and a post, allowing you to reference related updates from within a task.
Permissions
Reading tasks requires the tasks:read scope. Creating, updating, and deleting tasks and their sub-resources requires the tasks:write scope.