Skip to main content
GET
List canonical automations

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

agentId
string<uuid>

Return only automations configured to run this agent, across all pinned versions. Omit for all agents.

limit
integer
default:50

Maximum automation summaries to return. Defaults to 50.

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

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

Response

Bounded page of canonical automation summaries.

Bounded page of canonical automation summaries.

items
object[]
required

Canonical automations in newest-first order.

nextCursor
null | string
required

Opaque cursor for the next page, or null at the end.

total
integer<int64>
required

Total canonical automations visible to the caller.

Required range: 0 <= x <= 9007199254740991