Official documentation example for workflow creati...
# support
f
I'm reporting an issue where the official example from your documentation fails when trying to create a workflow via API. I used the exact cURL example from your documentation ( https://docs.vapi.ai/workflows/quickstart ), converted to Postman: From documentation: ```bash curl -X POST "https://api.vapi.ai/workflow" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Information Gathering Demo", "nodes": [ { "id": "start", "type": "conversation", "firstMessage": "Hey there!", "systemPrompt": "Ask users what kind of voice agent they want to build. Be friendly and conversational." } ], "edges": [] }' When executing this exact JSON payload, I receive the following error response: { "message": [ "Workflow 'Information Gathering Demo' must have a 'start' node", "each value in nodes.property id should not exist", "nodes has no start node" ], "error": "Bad Request", "statusCode": 400 } The API appears to reject the "id" property that is shown in the official documentation, and there's no clear way to mark a node as the start node. Could you please: Provide a working example that the current API accepts Update the documentation to reflect the current API requirements Clarify how to properly mark a start node without using the "id" field Thank you for your assistance! https://cdn.discordapp.com/attachments/1381052867686957106/1381052868001534114/Screenshot_2025-06-08_at_02.26.15.png?ex=68461d36&is=6844cbb6&hm=168715f265dba769e86d79e488911b6a6bfaa888a50f976dabcdefdaccaaf886&
v
To create a workflow via the Vapi API, do not include an
id
property in your node. Instead, mark the start node with
"isStart": true
. Here is a working example:
Copy code
json
{
  "name": "Information Gathering Demo",
  "nodes": [
    {
      "type": "conversation",
      "name": "Greeting",
      "prompt": "Hey there! Ask users what kind of voice agent they want to build. Be friendly and conversational.",
      "isStart": true
    }
  ],
  "edges": []
}
This should resolve the API error and create your workflow successfully. Sources: - [Vapi API Reference: Create Workflow](https://docs.vapi.ai/api-reference/workflow/workflow-controller-create?explorer=true) - [Vapi Changelog May 14, 2025](https://docs.vapi.ai/changelog/2025/5/14)
v
checking if this is resolved/solved for you?