Skip to main content
POST
Run an automation now

Authorizations

Authorization
string
header
required

Motion API key (motion_ prefix), authenticated as its owner. Account and engine permissions still apply.

Headers

Idempotency-Key
string<uuid>
required

New UUID for each intentional run. Reuse the same UUID after a lost response to avoid duplicate work.

Path Parameters

automation_id
string
required

ID returned by list or create.

Required string length: 1 - 200
Pattern: ^[a-zA-Z0-9_-]+$

Response

Existing invocation returned for a reused UUID.

automation
object
required

Owner-scoped read view. Read responses can include additional saved context and history. Use the dedicated run-history endpoint for pagination. Read fields are not accepted as write inputs.

run
object
required

Read view can also include event context, logs, artifacts, and connector snapshots. An accepted or completed agent run is not proof of a downloadable video; inspect saved exports in its Motion chat.

session
object
required
deduplicated
boolean
required