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

> Remove a transition (edge) between two workflow nodes without affecting the nodes themselves.

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

Removes a single edge between two workflow nodes. The source and destination nodes remain in place; only the directed transition between them is deleted. Leads that have already advanced past this edge keep moving through the rest of the graph normally, the deletion only affects future evaluations.

## When to use this

Edges encode "what happens next" decisions in a workflow. Delete an edge when:

* A branch is no longer needed, for example after consolidating two outcome paths into one.
* You want to remove a fallback transition after introducing a more specific condition through [Create Edge](/docs/api-reference/workflow-edges/create).
* A workflow is being refactored and you are rewiring transitions one at a time so you can validate the diff.

If you want to remove an entire node and everything connected to it, use [Delete Node](/docs/api-reference/workflow-nodes/delete) instead, that endpoint cleans up incoming and outgoing edges automatically.

## Behavior

* Deleting an edge does **not** delete the source or destination node.
* Leads that have already been routed by this edge stay on their current node.
* Leads currently arriving at the source node will no longer be eligible to follow this transition. If no other outgoing edge applies, they remain on the source node until you add a replacement edge or end the workflow.

## Path parameters

| Parameter | Description                                      |
| --------- | ------------------------------------------------ |
| `id`      | The workflow ID, for example `wfl_m3v7zb9rk2px`. |
| `edgeId`  | The edge ID, for example `edge_h4q8zn2vr6bx`.    |

## Errors

* `404 Not Found` is returned when the workflow or edge does not exist, or the edge does not belong to the specified workflow.
* `409 Conflict` is returned when deleting the edge would orphan an in-progress lead and the workflow's safety configuration forbids that. Resolve the orphaned lead first.

## Related endpoints

* [Create Edge](/docs/api-reference/workflow-edges/create): add a new transition between nodes.
* [List Edges](/docs/api-reference/workflow-edges/list): view all current transitions for a workflow.
* [Delete Node](/docs/api-reference/workflow-nodes/delete): remove a node and all its connected edges.


## OpenAPI

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

````