API ReferenceAgentsRuns
Create Test Run
Execute a workflow without placing a real phone call
Creates a test execution of the workflow. No outbound call is placed — this is useful for validating agent behavior, checking prompt outputs, and testing tool integrations before going live.
Path Parameters
workflow_id*Workflow Id
Header Parameters
X-API-Key?string|null
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/v1/workflow/0/runs" \ -H "Content-Type: application/json" \ -d '{ "mode": "string", "name": "string" }'{ "id": 0, "workflow_id": 0, "name": "string", "mode": "string", "created_at": "2019-08-24T14:15:22Z", "definition_id": 0, "initial_context": {}}