Start a saved agent run
Starts an asynchronous background run for a saved agent and returns the queued run record. Use the run retrieval endpoint to poll status or the events endpoint to stream progress.
Authorizations
Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.
Headers
Optional external end-user identifier forwarded by the API gateway.
Path Parameters
Body
1 - 20000Arbitrary JSON value.
Context management strategies to apply during agent-run response generation. Supports compaction, which summarizes older conversation history when the context exceeds a token threshold.
When true, the gateway generates per-token delta events for this run, so the events endpoint streams incremental output instead of only item and lifecycle boundaries. The run still executes in the background and this endpoint still returns the queued run record.
Response
Queued run.
agent.run The agent configuration version this run executed against. Null for runs created before versioning.
x >= 1queued, submitting, completed, failed Arbitrary JSON value.
Arbitrary JSON value.
Arbitrary JSON value.
Arbitrary JSON value.