GET /api/v1/runs
List Runs
filtered, paginated run list (default sort createtime:desc).
Auth: Authorization: Bearer <token> required
Request
Section titled “Request”curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/runs" \ -H "Authorization: Bearer <token>"Response 200
Section titled “Response 200”The contract carries no example for this response; schema: RunListResponse. Field-level shape: interactive explorer.
Returns
Section titled “Returns”RunListResponse — Successful Response
| Field | Type | Description |
|---|---|---|
items | array of PipelineRunRead | |
limit | integer (opt.) | |
offset | integer (opt.) | |
total | integer |
Parameters
Section titled “Parameters”| Parameter | In | Required | Type | Default | Constraints | Description |
|---|---|---|---|---|---|---|
status | query | no | string | null | — | — | |
pipeline_id | query | no | string | null | — | — | |
entity | query | no | string | null | — | — | |
contract | query | no | integer | null | — | — | |
limit | query | no | integer | 50 | min 1; max 200 | |
offset | query | no | integer | 0 | min 0 | |
sort | query | no | string | "createtime:desc" | — |
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.