Create Pathway Version

Creates a new version of a specific pathway, including its name, nodes, and edges.

POST /v1/pathway/{pathway_id}/version

Create Pathway Version

cURL

curl --request POST \
  --url https://api.bland.ai/v1/pathway/{pathway_id}/version \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "nodes": {},
  "edges": {}
}
'

Response

{
  "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.

Node Object Parameters

• 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.

Edge Object Parameters

• 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

Show properties

created_at · string

The timestamp when the new version was created.

id · string

The unique identifier of the newly created version.

name · string

The name of the newly created version.

version_number · integer

The version number of the newly created version.

Response

{
  "status": "success",
  "message": "Version created successfully",
  "data": {
    "created_at": "2024-03-07T10:15:30Z",
    "id": "v3_ghi789",
    "name": "Improved Customer Flow",
    "version_number": 3
  }
}

---

Docs for agents: llms.txt