Run an agent
Start a new run for an agent.
Runs always execute the agent’s live published version, so the agent must be
published first with POST /v1/agents/{agent_id}/publish. Unpublished drafts
cannot be run.
Authorizations
Path Parameters
The ID of the agent to run.
Body
Request body for starting an agent run.
Input values for the run. Keys should match the property names defined in schema.input. Omit the request body when the agent does not require inputs.
Response
Successful Response
Run details returned after a run request is accepted.
Unique ID for the accepted run.
Unique ID of the agent for this run.
Initial status of the accepted run.
queued, running, succeeded, failed, cancelled, skipped, unknown When the run started, if execution began immediately.