API: tasks
GET /api/v1/tasks
Section titled “GET /api/v1/tasks”List Tasks Endpoint
The read-only task board — paginated, filterable by assignee / status / area. Team-only (owner + team members); an agent or non-team token gets 403.
| Parameter | In | Required | Type |
|---|---|---|---|
assignee_id | query | no | object |
status | query | no | object |
area | query | no | object |
limit | query | no | integer |
offset | query | no | integer |
POST /api/v1/tasks
Section titled “POST /api/v1/tasks”Create
Create a task (agent needs manage_task; owner/humans no-op the gate).
GET /api/v1/tasks/{guid}
Section titled “GET /api/v1/tasks/{guid}”Get Task Endpoint
One task + its merged change-log (AgentAction ⊕ notes, SPEC-112 §3.4). Team-only; 404 if absent.
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |
PATCH /api/v1/tasks/{guid}
Section titled “PATCH /api/v1/tasks/{guid}”Patch
Change status (open↔closed) / reassign / edit; logs each field change.
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |
POST /api/v1/tasks/{guid}/notes
Section titled “POST /api/v1/tasks/{guid}/notes”Add Task Note
Append a free-text note to the task’s log (stored as a comment).
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |