List Nodes

Retrieve every node in a workflow, including type, label, and configuration, for rebuilding the workflow graph.

GET /workflows/{id}/nodes

List workflow nodes

cURL

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

200

{
  "data": [
    {
      "id": "node_abc",
      "workflow_id": "wf_abc123",
      "node_type": "VOICE_CALL",
      "label": "Initial Outreach Call",
      "position_x": 100,
      "position_y": 200,
      "config": {
        "agent_id": "agt_abc123",
        "from_phone_number": "[phone]"
      }
    }
  ]
}

Returns every node in the given workflow. Each entry includes the node’s id, the node_type (such as VOICE_CALL, TIME, CONDITIONAL, WEBHOOK, SMS), the human-readable label, and the node’s configuration. Combine this with List Edges to reconstruct the full workflow graph for visual editors, exports, and external tools.

When to use this

• Workflow visual editors: fetch the node set on load so the canvas can render every step.
• Workflow exports: produce a portable JSON snapshot of the workflow’s structure for backups or migrations.
• Audit and lint tooling: walk the node set to verify required configuration (for example a voice call node has an assigned agent, or a webhook node has a non-empty URL).
• Migration tooling: discover nodes that reference a deprecated agent or LLM before applying bulk updates.

Node types

Node type	What it does
VOICE_CALL	Places an outbound voice call using the configured agent.
TIME	Waits a configured duration before advancing the lead.
CONDITIONAL	Branches to different edges based on the previous step’s outcome.
WEBHOOK	Calls an external HTTP endpoint and waits for the response.
SMS	Sends an SMS where SMS capability is supported.

Node types may evolve as the platform adds new step kinds. Inspect the node_type field and treat unknown values as a hint to update your editor or tooling.

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/nodes" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    { "id": "node_v8p3kz1mq7ry", "node_type": "VOICE_CALL",  "label": "First Outreach Call" },
    { "id": "node_t2n6bw4pq9rz", "node_type": "TIME",        "label": "Wait 48 Hours" },
    { "id": "node_c5m9kx7vz3qp", "node_type": "CONDITIONAL", "label": "Check Outcome" }
  ]
}

Related endpoints

• List Edges: fetch the transitions between nodes.
• Create Node: add a new step.
• Update Node: change a node’s configuration.
• Delete Node: remove a step and its connected edges.

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