Read a run's log
Returns a page of a run's log lines, oldest first by default.
Last updated:
Returns a page of a run's log lines, oldest first by default.
GET /api/v1/executions/{executionId}/logs
Authorization
Requires a signed-in person with this scope: runs:read.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
X-Workspace-Id | header | yes | string (uuid) | The workspace the call acts in. Take it from the workspace list. |
executionId | path | yes | string (uuid) | The run's id. |
minLevel | query | no | one of DEBUG, INFO, WARNING, ERROR, CRITICAL | Keep only lines at or above this severity. |
logger | query | no | string | Keep only lines from this logger name, exactly. |
from | query | no | string (date-time) | Keep only lines produced at or after this time. |
to | query | no | string (date-time) | Keep only lines produced at or before this time. |
order | query | no | one of asc, desc | Sort order by production time: "asc" or "desc". |
page | query | no | integer | The page number, starting at 0. |
size | query | no | integer | The page size (default 100, capped at 1000). |
Responses
200
The log page.
| Field | Type | Required | Description |
|---|---|---|---|
items | list of object | yes | |
items[].id | string (uuid) | yes | |
items[].executionId | string (uuid) | yes | |
items[].producedAt | string (date-time) | yes | |
items[].seq | integer | yes | |
items[].level | one of DEBUG, INFO, WARNING, ERROR, CRITICAL | yes | |
items[].logger | string | no | |
items[].message | string | yes | |
items[].agentId | string (uuid) | no | |
items[].environmentName | string | no | |
items[].labels | string | no | |
totalElements | integer | yes | |
page | integer | yes | |
size | integer | yes | |
hasNext | boolean | yes |
Example response:
{
"items": [
{
"id": "7e5f6071-8293-a4b5-c6d7-e8f9a0b1c2d3",
"executionId": "6d4e5f60-7182-93a4-b5c6-d7e8f9a0b1c2",
"producedAt": "2026-10-12T09:10:05Z",
"seq": 1,
"level": "INFO",
"logger": "pipeline.execution",
"message": "Run started."
}
],
"totalElements": 1,
"page": 0,
"size": 100,
"hasNext": false
}400
The run id is not a well-formed id, or a query value (a page number, a time) is of the wrong kind.
| Field | Type | Required | Description |
|---|---|---|---|
message | string | yes | |
status | integer | yes | |
errorCode | string | yes | |
timestamp | string (date-time) | no | |
path | string | no | |
details | object | no |
404
There is no such run.
| Field | Type | Required | Description |
|---|---|---|---|
message | string | yes | |
status | integer | yes | |
errorCode | string | yes | |
timestamp | string (date-time) | no | |
path | string | no | |
details | object | no |