Tasks

Tasks are the primary unit of work. They belong to a team and can be nested under a parent task.

Status values

TODO · IN_PROGRESS · IN_REVIEW · BLOCKED · DONE · CANCELLED

LOW · MEDIUM · HIGH · URGENT

GET /task
Authorization: Bearer <token>

Returns a paginated list of tasks visible to the authenticated user.

GET /task/:id
Authorization: Bearer <token>

Also accepts the short reference form (e.g. PLAT-42).

POST /task
Authorization: Bearer <token>
Content-Type: application/json

{
  "title": "Fix login bug",
  "teamId": "team_01jq...",
  "status": "TODO",
  "priority": "HIGH",
  "dueDate": "2026-05-01"
}

Required: title, teamId.

PATCH /task/:id
Authorization: Bearer <token>
Content-Type: application/json

{ "status": "IN_PROGRESS", "assigneeId": "user_01jq..." }

All fields are optional; only provided fields are updated.

DELETE /task/:id
Authorization: Bearer <token>

GET /task/:id/task
Authorization: Bearer <token>

Returns child tasks nested under the given task.