Create a Task
Create a task with the right title, ownership, and optional planning context from the start.
Create a task over REST with the fields your workflow already knows and can justify.
- Use the right creation surface.
- Fill required fields first.
- Attach optional planning and ownership fields correctly.
Where this happens
Same Task, Other Interfaces
Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.
Do the work
- 1. Send a bearer token with `tasks.write`.
- 2. Include at least `title` and `teamId` in the JSON body.
- 3. Add optional fields only when they are meaningful now: `description`, `projectId`, `milestoneId`, `assigneeId`, `deadlineAt`, `priority`, `status`, and `tags`.
- 4. Read the creation result and keep the new task id for the next step in the workflow.
Create a task over REST
curl -X POST http://localhost:5173/api/v1/workspaces/ws_123/tasks -H 'authorization: Bearer access_token_here' -H 'content-type: application/json' -d '{"title":"Ship public docs","teamId":"team_123","priority":"high","status":"planned"}'Keep Going in Task Workflows
Stay in the same interface and move to the next closest task in this topic when needed.
Browse Tasks
Open the main task surface, narrow the visible list, and move from the collection view into the next task action.
Change Task Status
Move a task through its status lifecycle without losing the activity trail that explains what changed and why.
Update Task Details
Change ownership, deadlines, labels, project links, description, or other mutable task fields without conflating that work with a status transition.
Nearby Guides
These guides stay close to the current workflow so you can keep moving without restarting discovery.
Change Task Status
Move a task through its status lifecycle without losing the activity trail that explains what changed and why.
Update Task Details
Change ownership, deadlines, labels, project links, description, or other mutable task fields without conflating that work with a status transition.