One run, its history and any unconsumed signals

GET/apps/{appId}/runs/{runId}

Authenticate with an operator token or an app API key or a signed-in Foliot Console session.

Everything needed to explain a run’s current state in one call, which is what an operator opening a stuck run actually wants.

Path parameters

appId

string

REQUIRED

The app's name.

runId

string (uuid)

REQUIRED

Responses

200 object OK

400 Error Invalid request.

401 Error Missing, malformed or unknown bearer token.

403 Error The token is valid but not permitted on this route.

404 Error No such resource.

503 Error A dependency this route needs is unreachable.

{ "events": [ { "actor": "string", "at": "2026-10-01T09:30:00Z", "generation": 1, "id": 1, "payload": {}, "runId": "3f2b8c1e-5a44-4c7a-9d0e-1b6f2a7c9e10", "seq": 1, "type": "run.started" } ], "pendingSignals": [ { "createdAt": "2026-10-01T09:30:00Z", "name": "string", "payload": null } ], "run": { "appId": "string", "attempt": 1, "businessKey": null, "compacted": true, "createdAt": "2026-10-01T09:30:00Z", "currentStep": null, "error": { "message": "string" }, "finishedAt": null, "generation": 1, "id": "3f2b8c1e-5a44-4c7a-9d0e-1b6f2a7c9e10", "idempotencyKey": null, "input": null, "scheduledAt": null, "state": {}, "status": "running", "tags": [ "string" ], "updatedAt": "2026-10-01T09:30:00Z", "waitReason": null, "waitSignal": null, "workflowName": "string", "workflowVersion": 1 } }