create_task
Create a new task by specifying its status, title, description, priority, assignees, and due dates.
Instructions
Create a task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tag names to apply to the task on creation (native — set in one call). | |
| Space | No | Optional sub-space ID for further scoping inside the workspace. | |
| extra | No | Free-form payload (`_extra` on the model). | |
| order | No | ||
| title | No | ||
| parent | No | Parent task UUID (for subtasks). | |
| status | Yes | Target status UUID. | |
| complete | No | ||
| due_date | No | ||
| priority | No | Priority enum value. | |
| assignees | No | Integer user IDs to assign (get from listWorkspaceMembers). Composite field — toolkit calls POST /tasks/{id}/assignees/ automatically after creation. Note: assignees are NOT in the createTask response; use getTask?expand=assignees to verify. | |
| task_type | No | Task discriminator. Defaults to `TASK`. | |
| start_date | No | ||
| description | No | Plain text task description. This is the field agents and CLI users should set. The toolkit converts it to a Quill Delta and writes `rich_description` automatically. | |
| Organization | No | Workspace (organization) ID the request is scoped to. | |
| custom_fields | No | Map of custom field UUID → value. Validated against board's custom-field configuration. | |
| estimated_hours | No | Estimated completion time in hours. | |
| rich_description | No | INTERNAL — Quill Delta representation. Set automatically by the toolkit when you pass `description`. Do not pass directly unless you have a pre-built Delta and know what you're doing. |