List Edges

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

GET /workflows/{id}/edges

List workflow edges

cURL

curl --request GET \
  --url https://api.dialnexa.com/v1/workflows/{id}/edges \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "edge_abc",
      "workflow_id": "wf_abc123",
      "from_node_id": "node_abc",
      "to_node_id": "node_xyz",
      "label": "COMPLETED"
    }
  ]
}

Returns every edge in the given workflow. Each edge encodes a directed transition between two nodes: from_node_id is the source, to_node_id is the destination, and the optional label describes the condition that triggers the transition (for example COMPLETED, NO_ANSWER, VOICEMAIL). Combine with List Nodes to reconstruct the full workflow graph.

When to use this

• Visual editors: fetch the edge set so the canvas can draw transitions and conditional branches.
• Workflow exports: produce a portable JSON snapshot of the workflow structure for backups, migrations, or version control.
• Lint and audit tooling: verify every non-terminal node has at least one outgoing edge and that conditional nodes have a labelled edge for each expected outcome.
• Path-coverage reports: walk edges to compute which sequences of nodes leads can take and surface unreachable branches.

Edge labels

Edges may be unlabelled (the default transition between sequential steps) or labelled with a condition that ties them to an outcome of the source node. Labels are free-form strings; the values your workflow uses depend on the node types in play. Common labels include outcomes from a voice call node (COMPLETED, NO_ANSWER, VOICEMAIL, FAILED) and branches of a conditional node.

Path parameters

Parameter	Description
id	The workflow ID, for example wfl_m3v7zb9rk2px.

Errors

• 404 Not Found is returned when the workflow does not exist.

Request

curl "https://api.dialnexa.com/v1/workflows/wfl_m3v7zb9rk2px/edges" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "edge_h4q8zn2vr6bx",
      "from_node_id": "node_v8p3kz1mq7ry",
      "to_node_id": "node_t2n6bw4pq9rz",
      "label": null
    },
    {
      "id": "edge_k2p7vy5nq1mw",
      "from_node_id": "node_c5m9kx7vz3qp",
      "to_node_id": "node_converted",
      "label": "COMPLETED"
    }
  ]
}

Related endpoints

• List Nodes: fetch the workflow’s nodes.
• Create Edge: add a new transition.
• Delete Edge: remove a transition without removing its nodes.

Authorizations

Authorization · string · header · required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

id · string · required

Response

200 - application/json

Success.

data · object[]

Show child attributes