Delete Workflow

Permanently delete a workflow, along with its nodes, edges, and lead enrollments.

DELETE /workflows/{id}

Delete a workflow

cURL

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

200

{
  "message": "Workflow deleted."
}

Permanently deletes a workflow and everything attached to it: all nodes, all edges, all enrolled leads, and all per-lead progress state. This action cannot be undone. Call logs produced by previously completed calls remain available through Call Logs: only the workflow definition and enrollment state are removed.

When to use this

Workflow deletion is destructive and is intended for tear-down scenarios, not for pausing or temporarily disabling outreach. Use this when:

• A workflow was created in error and you want it permanently removed from your workspace.
• A pilot or experiment is finished, the data has been exported, and you want to clean up the dashboard.
• A workflow is being replaced by a new definition and you do not need the historical enrollment records to remain queryable.

If you only need to stop the workflow temporarily, use Pause Workflow instead. If you want to retire a workflow but keep its records, use Cancel Workflow: cancelled workflows remain visible in the dashboard but stop advancing leads.

Preconditions

Active workflows must be cancelled before they can be deleted. A workflow is “active” when its status is active or any leads are still in transit between nodes. Call Cancel Workflow first, then call this endpoint.

Path parameters

Parameter	Description
id	The workflow ID, for example wfl_m3v7zb9rk2px.

Errors

• 404 Not Found is returned when the workflow does not exist or has already been deleted.
• 409 Conflict is returned when the workflow is still active. Cancel it first.
• 403 Forbidden is returned when the caller’s API key does not have workflow delete permission. See Access Control.

Request

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

Response

{ "message": "success" }

Related endpoints

• Cancel Workflow: stop a workflow without removing its records.
• Pause Workflow: temporarily halt enrollment progress.
• List Workflows: confirm the workflow is gone after deletion.

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.

message · string

Example:

"Workflow deleted."