Add Edge

POST

workflows

{id}

edges

Create an edge in a workflow

curl --request POST \
  --url https://api.dialnexa.com/workflows/{id}/edges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_node_id": "node_abc123",
  "to_node_id": "node_xyz789",
  "label": "COMPLETED"
}
'

import requests

url = "https://api.dialnexa.com/workflows/{id}/edges"

payload = {
    "from_node_id": "node_abc123",
    "to_node_id": "node_xyz789",
    "label": "COMPLETED"
}
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({from_node_id: 'node_abc123', to_node_id: 'node_xyz789', label: 'COMPLETED'})
};

fetch('https://api.dialnexa.com/workflows/{id}/edges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/workflows/{id}/edges",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'from_node_id' => 'node_abc123',
    'to_node_id' => 'node_xyz789',
    'label' => 'COMPLETED'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/workflows/{id}/edges"

	payload := strings.NewReader("{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dialnexa.com/workflows/{id}/edges")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/workflows/{id}/edges")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}"

response = http.request(request)
puts response.read_body

Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.

Creates a directed edge between two nodes in a workflow. Edges encode the “what happens next” decision: after a lead finishes the step at from_node_id, the workflow checks each outgoing edge in order, picks the first edge whose label matches the outcome, and moves the lead to to_node_id. Unlabelled edges always match, they are the default next step for sequential flows. Labelled edges are required for CONDITIONAL nodes and recommended for any node where the outcome can branch.

When to use this

Building a new workflow: connect freshly created nodes into a graph after using Create Node.
Adding a branch: split a sequential workflow into multiple outcome-based paths.
Rewiring a workflow: after deleting an obsolete edge, create the replacement transition.

If you are editing a workflow that is currently active, be aware that edge changes take effect on the next scheduling tick. In-flight leads already past from_node_id are not affected.

Basic transition

For simple linear workflows, create one edge from each node to the next:

{
  "from_node_id": "node_call_1",
  "to_node_id": "node_wait_2days"
}

Conditional transitions

For CONDITIONAL nodes, create one edge per branch and set the label to match the branch name:

{
  "from_node_id": "node_check_outcome",
  "to_node_id": "node_second_call",
  "label": "FAILED"
}

{
  "from_node_id": "node_check_outcome",
  "to_node_id": "node_converted",
  "label": "COMPLETED"
}

Common label values for call-outcome branches are COMPLETED, FAILED, NO_ANSWER, and BUSY. For boolean conditions, use true and false. Custom values are accepted, but they must match what your CONDITIONAL node emits.

Path parameters

Parameter	Description
`id`	The workflow ID, for example `wfl_m3v7zb9rk2px`.

Errors

404 Not Found is returned when either node does not exist or does not belong to this workflow.
409 Conflict is returned when an edge with the same from_node_id, to_node_id, and label already exists.

List Edges: fetch all transitions in a workflow.
Delete Edge: remove a transition.
Create Node: add a node before connecting it.
List Nodes: confirm node IDs before creating an edge.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Body

application/json

from_node_id

string

required

ID of the source node

Example:

"node_abc123"

to_node_id

string

required

ID of the target node

Example:

"node_xyz789"

label

string

Label for the edge (e.g., "FAILED", "COMPLETED", "true", "false")

Maximum string length: 50

Example:

"COMPLETED"

Response

201

Edge created successfully

List EdgesRetrieve every edge (transition) in a workflow so you can rebuild the workflow graph alongside its nodes.

Create an edge in a workflow

curl --request POST \
  --url https://api.dialnexa.com/workflows/{id}/edges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_node_id": "node_abc123",
  "to_node_id": "node_xyz789",
  "label": "COMPLETED"
}
'

import requests

url = "https://api.dialnexa.com/workflows/{id}/edges"

payload = {
    "from_node_id": "node_abc123",
    "to_node_id": "node_xyz789",
    "label": "COMPLETED"
}
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({from_node_id: 'node_abc123', to_node_id: 'node_xyz789', label: 'COMPLETED'})
};

fetch('https://api.dialnexa.com/workflows/{id}/edges', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/workflows/{id}/edges",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'from_node_id' => 'node_abc123',
    'to_node_id' => 'node_xyz789',
    'label' => 'COMPLETED'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/workflows/{id}/edges"

	payload := strings.NewReader("{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dialnexa.com/workflows/{id}/edges")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/workflows/{id}/edges")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_node_id\": \"node_abc123\",\n  \"to_node_id\": \"node_xyz789\",\n  \"label\": \"COMPLETED\"\n}"

response = http.request(request)
puts response.read_body

Overview

Endpoints - v1

Endpoints - Legacy

Code Examples And SDK Status

When to use this

Basic transition

Conditional transitions

Path parameters

Errors

Authorizations

Path Parameters

Body

Response

​When to use this

​Basic transition

​Conditional transitions

​Path parameters

​Errors

​Related endpoints

Authorizations

Path Parameters

Body

Response

When to use this

Basic transition

Conditional transitions

Path parameters

Errors

Related endpoints