Skip to main content
GET
List canonical automation runs

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Query Parameters

automationId
string<uuid>

Narrow to one automation.

triggerId
string<uuid>

Narrow to one stored trigger. Manual runs have no trigger id.

eventSourceId
string<uuid>

Narrow to one event source.

triggerType
enum<string>

Narrow to one admission kind.

Available options:
manual,
schedule,
slack,
github,
webhook
status
enum<string>

Narrow to one session-creation outcome.

Available options:
pending,
created,
failed
createdAtGte
string<date-time>

Only runs recorded at or after this RFC 3339 instant.

createdAtLt
string<date-time>

Only runs recorded before this RFC 3339 instant.

limit
integer
default:50

Maximum run records to return. Defaults to 50.

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

Opaque cursor from nextCursor. Pass it unchanged with the same normalized filters and limit.

Response

A bounded snapshot-consistent page of canonical automation runs.

A bounded snapshot-consistent page of canonical automation runs.

items
object[]
required

Canonical automation runs, newest first.

nextCursor
null | string
required

Opaque continuation cursor, or null at the end.

total
integer<int64>
required

Total matching runs at the page's read snapshot.

Required range: x >= 0