Create from Definition

Create a voice agent from an explicit workflow definition

1 min read

post/api/v1/workflow/create/definition

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/workflow/create/definition \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "workflow_definition": {}
}'

Response

{
  "id": 1,
  "name": "<string>",
  "status": "<string>",
  "created_at": "2026-08-10T12:00:00Z",
  "workflow_definition": {},
  "current_definition_id": 1,
  "template_context_variables": {},
  "call_disposition_codes": {
    "disposition_codes": []
  },
  "total_runs": 1,
  "workflow_configurations": {},
  "version_number": 1,
  "version_status": "<string>",
  "workflow_uuid": "<string>"
}

post/api/v1/workflow/create/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.

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

namestringrequired#

workflow_definitionobjectrequired#

Responses

application/json

Successful Response

idintegerrequired#

namestringrequired#

statusstringrequired#

created_atstringrequired#

workflow_definitionobjectrequired#

current_definition_idinteger · nullrequired#

Show child attributes

Any of

template_context_variablesobject · null#

Show child attributes

Any of

call_disposition_codesobject · null#

Show child attributes

Any of

disposition_codesstring[]#

Default: []

total_runsinteger · null#

Show child attributes

Any of

workflow_configurationsobject · null#

Show child attributes

Any of

version_numberinteger · null#

Show child attributes

Any of

version_statusstring · null#

Show child attributes

Any of

workflow_uuidstring · null#

Show child attributes

Any of

Overview Create from Template