Skip to main content
DELETE
Soft-delete a workflow by ID
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.
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

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.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Path Parameters

id
string
required

Response

Workflow soft-deleted successfully