Talkr AI
API ReferenceAgents

Create from Definition

Create a voice agent from an explicit workflow definition

Creates an agent from a node and edge graph you provide directly. Use this when you want full control over the workflow structure, or when programmatically generating agents.

The workflow_definition object contains nodes (the steps in the conversation) and edges (transitions between steps). See Editing a Workflow for the full schema.

POST
/api/v1/workflow/create/definition

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/create/definition" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "workflow_definition": {}  }'
{  "id": 0,  "name": "string",  "status": "string",  "created_at": "2019-08-24T14:15:22Z",  "workflow_definition": {},  "current_definition_id": 0,  "template_context_variables": {},  "call_disposition_codes": {    "disposition_codes": []  },  "total_runs": 0,  "workflow_configurations": {},  "version_number": 0,  "version_status": "string",  "workflow_uuid": "string"}