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.
Auth: Authorization: Bearer <token> required
Request
Section titled “Request”curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/tasks" \ -H "Authorization: Bearer <token>"Response 200
Section titled “Response 200”The contract carries no example for this response; schema: TaskListResponse. Field-level shape: interactive explorer.
Returns
Section titled “Returns”TaskListResponse — Successful Response
| Field | Type | Description |
|---|---|---|
items | array of TaskRead | |
limit | integer (opt.) | |
offset | integer (opt.) | |
total | integer |
Parameters
Section titled “Parameters”| Parameter | In | Required | Type | Default | Constraints | Description |
|---|---|---|---|---|---|---|
assignee_id | query | no | integer | null | — | — | |
status | query | no | string | null | — | — | |
area | query | no | string | null | — | — | platform|pipelines|instances|other |
limit | query | no | integer | 50 | min 1; max 500 | |
offset | query | no | integer | 0 | min 0 |
Errors
Section titled “Errors”| Code | Meaning | Body |
|---|---|---|
401 | Missing or invalid authentication credentials | ErrorResponse |
422 | Validation Error | HTTPValidationError |
Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.