tasks_create
Create a task in this workspace. Leave the assignee empty to put it in the backlog, or name someone to hand it over.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Task title | |
| due_at | No | ISO datetime when the task is due, e.g. '2026-03-31T15:00:00Z'. A time without a zone is read as UTC. | |
| tag_ids | No | Topics for the task: ids of workspace tags that apply to tasks (ai_tags.list with applies_to='task'). Replaces the current set; [] clears it. | |
| agent_id | No | Act as this agent instead of as yourself — the task is recorded as authored by it. Optional. | |
| assignee | No | Who should do this: a workspace member (email, username, or user:<id> as workspace.members lists them), an AI agent (its name), or a contact (display name). Use 'me' for yourself. Call workspace.members to see who can be assigned. Where this listing offers assignee_user_id / assignee_agent_id / assigned_to_contact_id, they name an exact target instead. | |
| due_date | No | Date when task is due (e.g. '2026-03-31'). Use with due_time or alone. | |
| due_time | No | Time when task is due (e.g. '15:00'). Used with due_date. | |
| priority | No | Task priority (default: medium) | |
| thread_id | No | Related thread ID | |
| description | No | Detailed description | |
| repeat_unit | No | Unit for repeat_every. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| repeat_every | No | Make the task repeat: completing it creates the next occurrence, due this many repeat_unit after the previous deadline. E.g. repeat_every=3, repeat_unit='month' for quarterly. | |
| target_session | No | Which desktop Claude session should run this, by the name shown in workspace.desktops. Only needed when the assignee is an AI agent that runs on a machine and more than one session is connected — otherwise the task is not dispatched at all, rather than sent to a machine you did not mean. | |
| assignee_user_id | No | Exact workspace member to assign to | |
| assignee_agent_id | No | Exact AI agent to assign to | |
| attachment_file_ids | No | File IDs to attach (from files.upload) | |
| assigned_to_contact_id | No | Exact contact to assign to |