---
title: "Delete a workflow"
method: DELETE
path: "/v1/workflows/{id}"
tags: ["Workflows"]
---

# Delete a workflow

`DELETE /v1/workflows/{id}`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/workflows/{id}`
- Auth: HTTP bearer

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

- `id` string, required

## Response `200`

Deleted.

- object
  - `success` boolean, required

## Other responses

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

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)