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

# Delete Node

> Remove a node from a workflow, along with every incoming and outgoing edge connected to it.

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

Deletes a single node from a workflow. Every edge connected to the node, both incoming transitions from earlier steps and outgoing transitions to later steps, is automatically deleted in the same operation. Leads currently waiting at this node are not moved; they remain attached to the (now removed) node and will not advance further until you either remove them with [Remove Workflow Lead](/docs/api-reference/v1/workflow-leads/delete) or re-route them by adding new edges.

## When to use this

Node deletion is a structural change to the workflow graph. Use it when you are intentionally refactoring the sequence, not to pause work or to skip a step. Common cases:

* **Removing an obsolete step** when the business process no longer needs it.
* **Consolidating branches** so two parallel nodes collapse into a single canonical step.
* **Replacing a node** with a different action; delete the old one, then [Create Node](/docs/api-reference/workflow-nodes/create) to add the replacement and reconnect the edges.

If you only want to stop a node from running for a while, deactivate or detach its inbound edge instead. Deleting and re-adding the node is destructive, leads waiting on it lose their position in the workflow.

## Behavior

* All edges where this node is the source or destination are deleted along with the node.
* Leads waiting on this node are left in a stranded state until you intervene.
* Historical call logs from previous executions of this node remain visible in [Call Logs](/docs/api-reference/call-logs/list).

## Path parameters

| Parameter | Description                                      |
| --------- | ------------------------------------------------ |
| `id`      | The workflow ID, for example `wfl_m3v7zb9rk2px`. |
| `nodeId`  | The node ID, for example `node_v8p3kz1mq7ry`.    |

## Errors

* `404 Not Found` is returned when the workflow or node does not exist.
* `409 Conflict` is returned when deleting the node would leave the workflow without a valid entry point and the workflow's safety configuration forbids that.

## Related endpoints

* [Create Node](/docs/api-reference/workflow-nodes/create): add a replacement node.
* [List Nodes](/docs/api-reference/workflow-nodes/list): confirm the node is gone.
* [Delete Edge](/docs/api-reference/workflow-edges/delete): remove a single transition without removing its nodes.


## OpenAPI

````yaml DELETE /workflows/{id}/nodes/{nodeId}
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/{nodeId}:
    delete:
      tags:
        - Workflows
      summary: Delete a node from a workflow
      description: >-
        **Legacy endpoint - deprecated, scheduled for removal on July 31,
        2026.** Use the `/v1` version for new integrations. 
      operationId: WorkflowsController_deleteNode
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: nodeId
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Node deleted successfully
      deprecated: true
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````