Skip to main content
GET
Get a canonical automation

Authorizations

Authorization
string
header
required

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

Headers

If-None-Match
string

Strong ETag from an earlier member read. A match returns 304 without a body.

Path Parameters

automationId
string<uuid>
required

Stable canonical automation identifier.

Response

Full round-trippable canonical automation aggregate.

Full round-trippable canonical automation aggregate.

agentId
string<uuid>
required

Managed agent selected by this automation.

agentVersionId
string<uuid>
required

Immutable agent version pinned for all admitted runs.

automationId
string<uuid>
required
read-only

Stable canonical automation identifier.

createdAt
string<date-time>
required
read-only

Time the automation was created.

displayName
string
required

Human-readable automation name.

environmentId
string<uuid>
required

Execution environment selected for admitted sessions.

initialPrompt
object
required

Prompt definition frozen onto admitted runs.

Example:
revision
integer<int64>
required
read-only

Monotonic aggregate revision represented by the response ETag.

Required range: x >= 1
runDefaults
object
required

Run defaults frozen onto admitted runs.

Example:
status
enum<string>
required
read-only

Lifecycle state. New automations start paused.

Available options:
paused,
active
triggers
object[]
required

Complete ordered trigger set.

Closed schedule-trigger configuration.

Example:
updatedAt
string<date-time>
required
read-only

Time the aggregate was last changed.