Automation ID (auto_...) or lookup_key of the automation to invoke.
Request body.
Optionalidempotency_key?: stringUnique key to deduplicate concurrent or retried invocations. A second request with the same key returns the existing run instead of creating a new one.
Optionalpayload?: Record<string, unknown>Arbitrary input data passed to the automation. Validated against the automation's input_schema when one is configured; the request is rejected with 422 if validation fails.
The automation run created by this invocation.
Invoke an automation Triggers a single run of an automation that has
type: "invoked". Returns the resulting automation run object, which you can use to poll or display run status. Both server-to-server (secret key) and user (publishable key + JWT) auth are supported. The automation'sinvoke_authsetting controls which auth modes are accepted; requests using an unsupported mode are rejected with 403. For server-to-server callers the run executes under the identity configured in the automation'srun_as_userorrun_as_agentfields. For authenticated user callers the invoking user's identity is used automatically. If you supply anidempotency_key, a second request with the same key returns the existing run rather than creating a new one.