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

NameInRequiredTypeDescription
X-Workspace-Idheaderyesstring (uuid)The workspace the call acts in. Take it from the workspace list.
executionIdpathyesstring (uuid)The run's id.
minLevelquerynoone of DEBUG, INFO, WARNING, ERROR, CRITICALKeep only lines at or above this severity.
loggerquerynostringKeep only lines from this logger name, exactly.
fromquerynostring (date-time)Keep only lines produced at or after this time.
toquerynostring (date-time)Keep only lines produced at or before this time.
orderquerynoone of asc, descSort order by production time: "asc" or "desc".
pagequerynointegerThe page number, starting at 0.
sizequerynointegerThe page size (default 100, capped at 1000).

Responses

200

The log page.

FieldTypeRequiredDescription
itemslist of objectyes
items[].idstring (uuid)yes
items[].executionIdstring (uuid)yes
items[].producedAtstring (date-time)yes
items[].seqintegeryes
items[].levelone of DEBUG, INFO, WARNING, ERROR, CRITICALyes
items[].loggerstringno
items[].messagestringyes
items[].agentIdstring (uuid)no
items[].environmentNamestringno
items[].labelsstringno
totalElementsintegeryes
pageintegeryes
sizeintegeryes
hasNextbooleanyes

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.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno

404

There is no such run.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno