| Type | Description |
|---|---|
task | Created by users for manual work tracking |
hil_approval | Created by AI agents when they need human approval before proceeding |
Task lifecycle
Tasks move through these statuses:| Status | Description |
|---|---|
todo | Not started (default) |
in_progress | Work has begun |
in_review | Pending review |
done | Completed |
canceled | No longer needed |
Priority levels
Tasks can be prioritized asurgent, high, medium (default), or low.
Context entities
Tasks can be linked to related entities — invoices, parties, or messages — to provide context. Use the context search endpoint to find linkable entities.Endpoints
List tasks
Paginated, filtered task list
Get task
Full task detail with hydrated context
Create task
Create a new user task
Update task
Update a task or resolve an HIL approval
Delete task
Delete a user task
Filter options
Available values for filter controls
Context search
Search entities to link to tasks