Talkr AI
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.

POST
/api/v1/workflow/{workflow_id}/runs

Path Parameters

workflow_id*Workflow Id

Header Parameters

authorization?string|null
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": {}}