Tasks
AI agents: read /llms.txt; add .md to any page URL. This page as Markdown: /reference/tasks.md. Index of every page and the rules for every call: /llms.txt. Guides and concepts in one file: /llms-full.txt. OpenAPI: /openapi.json.
Tasks are the production steps of a job (the work pipeline). Each comes from a task preset, which sets its statuses; a task has dates, a position and assignees.
10 operations
- POSTAdd a task to a job
/Checkv2/ api/ store/ {team_slug}/ v2/ job/ {hash_id}/ work_pipeline success, not only the HTTP status: when the job's order is neither a draft nor published, this call answers HTTP 200 with{ "status": 500, "success": false, "error": { "code": "action_not_allowed", "message": null } }and creates… - GETList the tasks of a job
/Checkv2/ api/ store/ {team_slug}/ v2/ job/ {hash_id}/ work_pipeline success, not only the HTTP status: when the job's order is neither a draft nor published, this call answers HTTP 200 with{ "status": 500, "success": false, "error": { "code": "action_not_allowed", "message": null } }instead of… - POSTList tasks in a date range
/Tasks whose start or due date falls in the range, or whose dates span it.v1/ api/ store/ {team_slug}/ work_pipeline/ calendar - POSTFilter tasks
/Returns one page of your team's tasks across all jobs that match the filters, in the order you ask for.v1/ api/ store/ {team_slug}/ work_pipeline/ filter - GETGet a task
/Returns one task: its job and order, preset, status, dates, position and assignees.v2/ api/ store/ {team_slug}/ v2/ work_pipeline/ {hash_id} - PUTUpdate a task
/Changes a task's name, note, preset, status, position, dates or assignees, and returns it.v2/ api/ store/ {team_slug}/ v2/ work_pipeline/ {hash_id} - PUTAssign or unassign a person on a task
/Adds one team member to a task, or removes one.v2/ api/ store/ {team_slug}/ v2/ work_pipeline/ {hash_id}/ assign - PUTChange a task's status
/Moves a task to another status of its task preset.v2/ api/ store/ {team_slug}/ v2/ work_pipeline/ {hash_id}/ status - POSTReorder tasks
/Sets the position of several tasks at once, as the web app does when you drag tasks on a board or within a job.v1/ api/ store/ {team_slug}/ work_pipeline/ bulk_update_position - DELETEDelete a task
/Deletes a task.v2/ api/ store/ {team_slug}/ v2/ work_pipeline/ {hash_id}