curl --request POST \
  --url https://agents.labs.bandwidth.com/api/v1/workflow/create/definition \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "Receptionist",
  "workflow_definition": {
    "nodes": [
      {
        "id": "start-1",
        "type": "startCall",
        "position": {
          "x": 0,
          "y": 0
        },
        "data": {
          "name": "Start",
          "prompt": "You are a friendly assistant. Greet the caller and ask how you can help."
        }
      },
      {
        "id": "end-1",
        "type": "endCall",
        "position": {
          "x": 400,
          "y": 0
        },
        "data": {
          "name": "End",
          "prompt": "Thank the caller and say goodbye."
        }
      }
    ],
    "edges": [
      {
        "id": "edge-1",
        "source": "start-1",
        "target": "end-1",
        "data": {
          "label": "Done",
          "condition": "The caller's question has been answered and they want to end the call"
        }
      }
    ]
  }
}
EOF

import requests

url = "https://agents.labs.bandwidth.com/api/v1/workflow/create/definition"

payload = {
    "name": "Receptionist",
    "workflow_definition": {
        "nodes": [
            {
                "id": "start-1",
                "type": "startCall",
                "position": {
                    "x": 0,
                    "y": 0
                },
                "data": {
                    "name": "Start",
                    "prompt": "You are a friendly assistant. Greet the caller and ask how you can help."
                }
            },
            {
                "id": "end-1",
                "type": "endCall",
                "position": {
                    "x": 400,
                    "y": 0
                },
                "data": {
                    "name": "End",
                    "prompt": "Thank the caller and say goodbye."
                }
            }
        ],
        "edges": [
            {
                "id": "edge-1",
                "source": "start-1",
                "target": "end-1",
                "data": {
                    "label": "Done",
                    "condition": "The caller's question has been answered and they want to end the call"
                }
            }
        ]
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Receptionist',
    workflow_definition: {
      nodes: [
        {
          id: 'start-1',
          type: 'startCall',
          position: {x: 0, y: 0},
          data: {
            name: 'Start',
            prompt: 'You are a friendly assistant. Greet the caller and ask how you can help.'
          }
        },
        {
          id: 'end-1',
          type: 'endCall',
          position: {x: 400, y: 0},
          data: {name: 'End', prompt: 'Thank the caller and say goodbye.'}
        }
      ],
      edges: [
        {
          id: 'edge-1',
          source: 'start-1',
          target: 'end-1',
          data: {
            label: 'Done',
            condition: 'The caller\'s question has been answered and they want to end the call'
          }
        }
      ]
    }
  })
};

fetch('https://agents.labs.bandwidth.com/api/v1/workflow/create/definition', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": 42,
  "name": "Receptionist",
  "status": "draft",
  "created_at": "2026-11-01T12:00:00Z",
  "workflow_definition": {
    "nodes": [
      {
        "id": "start-1",
        "type": "startCall",
        "position": {
          "x": 0,
          "y": 0
        },
        "data": {
          "name": "Start",
          "prompt": "You are a friendly assistant. Greet the caller and ask how you can help."
        }
      },
      {
        "id": "end-1",
        "type": "endCall",
        "position": {
          "x": 400,
          "y": 0
        },
        "data": {
          "name": "End",
          "prompt": "Thank the caller and say goodbye."
        }
      }
    ],
    "edges": [
      {
        "id": "edge-1",
        "source": "start-1",
        "target": "end-1",
        "data": {
          "label": "Done",
          "condition": "The caller's question has been answered and they want to end the call"
        }
      }
    ]
  },
  "current_definition_id": 101,
  "workflow_uuid": null,
  "version_number": null,
  "version_status": null
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "ctx": {},
      "input": "<unknown>"
    }
  ]
}