# Delete a workflow

> Remove a workflow. Nothing fires again, and it drops out of every read.

Canonical: https://revnu.com/docs/workflow-delete
Last updated: 2026-10-15

```bash
curl -X DELETE -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/workflows/j57…
```

## Response

`{ "ok": true, "name": "…" }`. The workflow disappears from `GET /workflows`, its pending wake is cancelled, and `GET /workflows/{id}/runs` answers `404` from then on. `404` for an unknown or another account's workflow.

## Frequently asked questions

### Can I undo a delete?

No. To stop a workflow and keep it, [pause](https://revnu.com/docs/workflow-pause.md) it instead. Leads a deleted workflow found stay in your leads.

### Which scope does this need?

`workflows:write`. A token without it gets `403` with `requiredScope` in the body. `GET /me` shows a token's scopes.

### Are responses cached?

No. Every response is `Cache-Control: no-store`, so what you read is current.