Skip to main content
GET
List workflow runs

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

id
number
required

Numeric workflow id.

Example:

42

Query Parameters

status
string

Filter by run status (running / awaiting_human / completed / error / cancelled / all_executions).

timeframe
string

Filter by run timeframe (e.g. last_hour / last_day / last_week).

approvalScope
string

Approval scope filter (mine / all). Only meaningful with status=awaiting_human.

Case-insensitive substring filter on the parent workflow name.

pageSize
number

Max items per page. Defaults to 25, clamped to 100.

Required range: 1 <= x <= 100
pageToken
string

Opaque page token from a previous response's nextPageToken. Omit for the first page.

Response

runs
object[]
required

Page of run summaries, most recent first.

counts
object
required

Per-status counts (all_executions / running / awaiting_human / error / completed).

Example:
nextPageToken
string | null

Opaque token for the next page; null when this was the last page. Pass as pageToken on the next request.