Delete a workflow

DELETE/v1/workflows/{id}

Secret key — sk_… or sk_test_… · Base URL https://api.volanea.com

Deletes the workflow definition.

Executions already in flight are not deleted and not cancelled by this call. An enrolment sitting on a delay keeps its wake timer, so removing a workflow is not the same as stopping the automation it is running. Call POST /v1/workflows/{id}/executions/cancel-all first if you want the contacts currently inside it to stop where they are.

Pausing with PATCH /v1/workflows/{id} is the reversible way to stop new enrolments.

Path parameters

idstringrequired
Workflow id.

Response

Deleted.

successbooleanrequired

Errors

Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.

401Missing or invalid API key.
404Not found.
422Request validation failed (code `validation_error`, 422).

Request

curl https://api.volanea.com/v1/workflows/id_123 \
  -X DELETE \
  -H "Authorization: Bearer sk_..."

Response

200 · application/json

{
  "success": true,
  "data": {
    "success": true
  }
}

92 endpoints · OpenAPI document