Skip to main content
GET
Get one canonical automation run

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

Path Parameters

automationRunId
string<uuid>
required

Stable canonical automation-run identifier.

Response

Canonical record of one admitted automation run and its frozen execution context.

Canonical record of one admitted automation run and its frozen execution context.

automationId
string<uuid>
required

Automation whose frozen configuration admitted the run.

automationRunId
string<uuid>
required

Stable run identifier and asynchronous status handle.

automationSnapshot
object | null
required

Bounded non-secret automation configuration frozen at admission.

createdAt
string<date-time>
required

Time the run was admitted.

effectiveInitialMessage
string
required

Complete initial message supplied to the admitted session.

promptSnapshot
object | null
required

Prompt definition frozen at admission.

status
enum<string>
required

Session-creation outcome.

Available options:
pending,
created,
failed
statusUrl
string
required

Canonical member URL for polling this run.

triggerType
enum<string>
required

Admission kind.

Available options:
manual,
schedule,
slack,
github,
webhook
updatedAt
string<date-time>
required

Time the run outcome last changed.

completedAt
string<date-time>

Time session creation succeeded or failed.

error
object

Terminal admission failure. Present only for failed runs.

eventContext
object

Bounded normalized delivery context or deliberately open manual payload.

eventSourceId
string<uuid>

Event source that received the delivery for provider and custom-webhook runs.

eventSummary
string

One-line description of the event that started the run, such as the GitHub action, repository, number and label, or the start of a Slack message. Absent for manual and schedule runs and when the event carries nothing to describe.

occurrenceAt
string<date-time>

Schedule occurrence represented by this run.

providerDeliveryId
string

Verified provider delivery identity used for deduplication.

sessionAction
enum<string>

What the run did with its session. Present only for created runs of a Slack trigger whose continuation is resume_thread: started for the first post in a thread, appended when the thread's session was still working, resumed when it had finished, and successor when it was gone and a new session replaced it.

Available options:
started,
appended,
resumed,
successor
sessionId
string<uuid>

Managed-agent session the run started or was delivered into. Present only for created runs.

sourceSnapshot
object

Bounded non-secret source configuration frozen for event runs.

triggerId
string<uuid>

Stored trigger that admitted the run. Absent for manual runs.

triggerIncarnation
integer

Trigger incarnation frozen at admission. Absent for manual runs.

Required range: 1 <= x <= 9007199254740991
triggerSnapshot
object

Bounded trigger configuration frozen at admission. Absent for manual runs.