Skip to main content
🐙
Docs

Tasks API

Create, read, update, and delete tasks via the Delegate REST API.

#List tasks

GET /api/tasks

Returns tasks for the authenticated user's active workspace.

Query paramTypeDescription
statusstringFilter by status: todo, in_progress, done
prioritystringFilter: urgent, high, medium, low
assigneestringFilter by user ID
projectIdstringFilter by project ID
limitnumberMax results (default 50, max 200)
cursorstringPagination cursor from previous response

#Create task

POST /api/tasks
Request Body
{
  "title": "Review Q2 report",
  "description": "Check figures against last quarter",
  "dueDate": "2026-03-20T17:00:00Z",
  "priority": "high",
  "assigneeId": "user_abc123",
  "projectId": "proj_xyz789"
}

#Update task

PATCH /api/tasks/:id

Partial update — include only the fields you want to change.

#Delete task

DELETE /api/tasks/:id

Permanently deletes the task. Returns 204 No Content.