Skip to main content
GET
List flow runs

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Query Parameters

limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string | null

next_cursor from the previous page

status
enum<string>[] | null

Only runs in these states (comma-separated, or repeated). Default: every state but queued

Available options:
queued,
running,
completed,
failed,
waiting,
awaiting_approval
since
string<date-time> | null

Only runs that started at or after this, ISO 8601 (UTC when no offset)

until
string<date-time> | null

Only runs that started before this, ISO 8601

record_object
enum<string> | null

Only runs on this kind of record

Available options:
account,
contact,
opportunity,
project,
task,
user,
activity,
meeting,
warehouse_row,
other
record_id
string | null

Only runs on the record with this id

Maximum string length: 255
flow
string | null

Only this flow's runs, an id from GET /v1/automations/flows. An unknown or deleted flow is a 404

Maximum string length: 64

Response

200 - application/json

Successful Response

data
AutomationRun · object[]
required
has_more
boolean
default:false
next_cursor
string | null
summary
RunSummary · object | null

Counts over every run the filters match, not just this page. On the first page only (no cursor); null on later pages, so paging does not count again