List Runs

See every time a workflow ran. Filter by status, environment, version, or date to find the runs you care about.

GET

Path

Path parameters

stringrequired

The workflow's id, from List Workflows.

Headers

Optional headers

string

Optional. The id of a child organization of your API key's company to act on. Leave it out to act on the key's own company. See Child organizations.

Query

FiltersNarrow list results with a provider-supported where expression. Learn more

string

RSQL expression used to filter list results.

PaginationRequest a specific window of rows with limit and offset. Learn more

number

Maximum number of rows to return.

number

Number of rows to skip.

SortingChoose the order of returned rows when this action supports sorting. Learn more

string

Comma-separated sort fields; prefix with - for descending.

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Response fields

idstring

Unique id of the run.

workflowIdstring

The workflow this run belongs to.

statusstring

Where the run stands or how it ended: waiting, running, finished, failed, cancelled, interrupted, limitExceeded, or cancelling.

versionstring

The workflow version that ran, or "draft".

environmentIdstring

The environment the run targeted.

environmentNamestring

That environment's name.

startedOndate

When the run started.

finishedOndate

When the run finished. Empty while it is still going.

durationMsnumber

How long the run took, in milliseconds.

operationsnumber

How many tasks the run used. This is the number that counts against your limit.

errorCountnumber

How many errors the run logged.

warningCountnumber

How many warnings the run logged.

infoCountnumber

How many info entries the run logged.

endUserIdstring

The embedded end user the run belongs to, if any.

installationIdstring

The embedded installation the run belongs to, if any.

triggerAppSlugstring

The app that triggered the run.