---
title: "Delete a workflow"
method: DELETE
path: "/workflows/{uid}"
---

# Delete a workflow

`DELETE /workflows/{uid}`

## Request

- Base URL: `https://api.bannerbear.com/v5`
- URL: `https://api.bannerbear.com/v5/workflows/{uid}`
- Auth: HTTP bearer

Discards the workflow. Its past runs are kept.

## Path parameters

- `uid` string, required

## Response `204`

Workflow discarded

## Other responses

- `403`: Workflow is restricted to updates from its owner's API keys
- `404`: Workflow not found in this workspace
- `423`: Workflow is locked from API updates

## Changes

- **2026-09-09** `b98735eaab44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/changes/workflows/:uid/delete.md)

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) - [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/revisions/357256cbd1e5?raw)