Skip to main content
POST
Create Task
Files a task in a workspace, for a person or for one agent, optionally with a reviewer, tags, links and a parent task. Every task lives in a workspace; there are no personal or team tasks. An agent that wants to act outside the workspace proposes instead, and one that already did the work reports it. You need task-write access in the workspace (an internal member who is not a viewer, or an external editor). Auth: Authorization: Bearer tr_...

Request body

Returns 201 with the new task in data, in the shape shown on Get Task with its links (without children and timeline). A new task is todo at revision 1, with holder: null; createdBy names you.

Error codes

Operator mirror

POST /v0/operator/tasks takes the same body without why, with an operator session acting as the bound account; workspaceId is the workspace id.