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.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

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: 0 <= x <= 9007199254740991