v1

latestOpenAPI 3.1.0MIT2026-07-1791318.6 KB

Agents

Execute an agent

Triggers execution of a Station agent with the given task. Returns immediately with a run ID that can be used to poll for status.

post/execute

agent_namestring

Name of the agent to execute (mutually exclusive with agent_id)

agent_idinteger

ID of the agent to execute (mutually exclusive with agent_name)

taskstring required

The task/prompt to send to the agent

variablesobject

Optional variables to pass to the agent

Agent execution started

run_idinteger required

Unique identifier for this execution run

agent_idinteger required

agent_namestring required

status'running' | 'completed' | 'failed' required

messagestring required