> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Nodes

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

<Warning>
  **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.
</Warning>

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](/docs/api-reference/workflow-edges/list) 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.

## Related endpoints

* [List Edges](/docs/api-reference/workflow-edges/list): fetch the transitions between nodes.
* [Create Node](/docs/api-reference/workflow-nodes/create): add a new step.
* [Update Node](/docs/api-reference/workflow-nodes/update): change a node's configuration.
* [Delete Node](/docs/api-reference/workflow-nodes/delete): remove a step and its connected edges.


## OpenAPI

````yaml GET /workflows/{id}/nodes
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /workflows/{id}/nodes:
    get:
      tags:
        - Workflows
      summary: Get all nodes in a workflow
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 
      operationId: WorkflowsController_getNodes
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Nodes fetched successfully
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````