Skip to main content
POST
https://api.bland.ai
/
v1
/
pathway
/
{pathway_id}
/
version
Create Pathway Version
curl --request POST \
  --url https://api.bland.ai/v1/pathway/{pathway_id}/version
{
  "status": "success",
  "message": "Version created successfully",
  "data": {
    "created_at": "2024-03-07T10:15:30Z",
    "id": "v3_ghi789",
    "name": "Improved Customer Flow",
    "version_number": 3
  }
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
pathway_id
string
required
The ID of the pathway for which to create a new version.

​
Request Body

​
name
string
required
The name of the new pathway version.
​
nodes
array of objects
required
An array of node objects defining the structure of the pathway.
  • id — Unique identifier of the node
  • type — Type of the node (e.g., “Default”, “End Call”, “Webhook”)
  • data — Object containing node-specific data
    • name — Name of the node
    • text or prompt — Text or prompt associated with the node
    • Other properties specific to the node type
​
edges
array of objects
required
An array of edge objects defining the connections between nodes.
  • id — Unique identifier of the edge
  • source — ID of the source node
  • target — ID of the target node
  • label — Label for this edge

​
Response

​
status
string
The status of the operation (e.g., “success”).
​
message
string
A message describing the result of the operation.
​
data
object
{
  "status": "success",
  "message": "Version created successfully",
  "data": {
    "created_at": "2024-03-07T10:15:30Z",
    "id": "v3_ghi789",
    "name": "Improved Customer Flow",
    "version_number": 3
  }
}