API referenceAgent spec
Execute an Agent Spec flow
Submit an Agent Spec flow for execution on the configured runtime (WayFlow, PyAgentSpec, or other compatible runtimes). The flow is posted as Agent Spec JSON. The runtime returns an execution ID for tracking progress via polling or WebSocket.
AuthorizationBearer <token>
JWT token for authentication
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request to execute an Agent Spec flow on a runtime
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/agentspec/flows/execute" \ -H "Content-Type: application/json" \ -d '{ "flow": { "component_type": "flow", "name": "document_processing", "start_node": "start", "nodes": [ { "component_type": "start_node", "name": "process_input" } ], "control_flow_connections": [ { "name": "start_to_process", "from_node": "start", "to_node": "process_input" } ] } }'{ "execution_id": "exec-abc-123", "id": "string", "status": "running"}