Run a canonical automation manually
Atomically freezes the automation and optional payload into one pending run. Explicit manual runs remain available while the automation is paused. The complete HTTP request scope and Idempotency-Key identify the durable result.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Replay-protection key in an organization-wide namespace shared by keyed mutations. It must contain 1 to 256 visible ASCII characters and be sent as exactly one header value. Request identity is the exact HTTP method, escaped path, raw query, and raw body bytes. The same request replays the original successful response; any different request returns 409 idempotency_conflict, and an active matching request returns 409 idempotency_in_progress. Completed receipts are retained for approximately 24 hours, pending claims may be reclaimed after approximately 1 hour, and no deduplication is guaranteed after expiry.
1 - 256^[!-~]+$Path Parameters
Stable canonical automation identifier.
Body
Structured input for explicitly running a canonical automation.
Optional deliberately open JSON value supplied to this run and frozen in its event context.
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.
Automation whose frozen configuration admitted the run.
Stable run identifier and asynchronous status handle.
Bounded non-secret automation configuration frozen at admission.
Time the run was admitted.
Complete initial message supplied to the admitted session.
Prompt definition frozen at admission.
Session-creation outcome.
pending, created, failed Canonical member URL for polling this run.
Admission kind.
manual, schedule, slack, github, webhook Time the run outcome last changed.
Time session creation succeeded or failed.
Terminal admission failure. Present only for failed runs.
Bounded normalized delivery context or deliberately open manual payload.
Event source that received the delivery for provider and custom-webhook runs.
Schedule occurrence represented by this run.
Verified provider delivery identity used for deduplication.
Created managed-agent session. Present only for created runs.
Bounded non-secret source configuration frozen for event runs.
Stored trigger that admitted the run. Absent for manual runs.
Trigger incarnation frozen at admission. Absent for manual runs.
x >= 1Bounded trigger configuration frozen at admission. Absent for manual runs.