Validate Agent Spec flow on runtime
Validate an Agent Spec flow specification against the runtime without executing it. Checks for structural correctness, valid node references, and property compatibility.
JWT token for authentication
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Agent Spec Flow — a directed, potentially cyclic graph of nodes. Flows function as "subroutines" encapsulating repeatable processes. They separate control-flow (execution order) from data-flow (data routing).
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/agentspec/flows/validate" \ -H "Content-Type: application/json" \ -d '{ "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" } ] }'{ "valid": true, "errors": [ "string" ]}Stream Agent Spec execution updates (WebSocket) GET
WebSocket endpoint for real-time execution updates. Streams per-node status changes and execution events as they occur. **Protocol**: WebSocket (upgrade from HTTP) **Messages sent by server**: - `{"type": "node_status", "node": "<name>", "status": {...}}` - `{"type": "execution_complete", "results": {...}}` - `{"type": "execution_error", "error": "<message>"}`
Export workflow as Agent Spec JSON GET
Convert a FlowDrop workflow to Agent Spec format and return it. The conversion: - Maps FlowDrop node types to Agent Spec component types - Splits unified edges into control_flow_connections and data_flow_connections - Stores FlowDrop-specific data (positions, dynamic ports) in metadata extensions - Validates the workflow for Agent Spec compatibility before export This is the Agent Spec counterpart of the FlowDrop-native `GET /workflows/{id}/export` under **Import and Export**.