foliot docs

API reference / Runs / One run, without its history

One run, without its history

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

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

The run alone: getRun without the event history or the pending signals. For a client that mirrors a run’s status: getRun returns up to 1000 events, each carrying a payload, so a long-lived run can pass a client’s response-size cap and become unreadable through it. This response is never larger than getRun’s and is normally far smaller, but it is not capped: the run still carries its input and state, and state is whatever the run’s steps have stored — Foliot does not limit how large it accumulates. The run is the same object getRun and every operator action return.

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.