---
title: "Delete a Workflow"
method: DELETE
path: "/v3/workflows/{workflowName}"
tags: ["Workflows"]
---

# Delete a Workflow

`DELETE /v3/workflows/{workflowName}`

**Delete a workflow and every one of its versions.**

Permanent. Running and queued calls against this workflow continue
to completion against the version they captured at call time;
subsequent attempts to call the workflow return `404 Not Found`.

Functions referenced by the deleted workflow are not removed — they
remain available to other workflows or for direct reference.

Any connectors attached to the workflow are torn down first. Teardown is
best-effort: per-connector failures are reported in `connectorErrors` but
do not block the deletion, so check that array rather than relying on the
status code alone.

## Path parameters

- `workflowName` string, required

## Response `200`

The request has succeeded.

- WorkflowDeleteResponseV3
  - `workflow` WorkflowVersionIdentifier
    - `id` string, required — Unique identifier of workflow.
    - `name` string, required — Unique name of workflow. Must be UNIQUE on a per-environment basis.
    - `versionNum` integer, required — Version number of workflow version.
  - `error` string — Error message if the workflow deletion failed.
  - `connectorErrors` WorkflowConnectorError[] — Per-connector failures from tearing down the deleted workflow's connectors. Connector teardown is best-effort: a failure here is reported but does not block the deletion, so a `200` response with a non-empty `connectorErrors` means the workflow is gone while one or more of its connectors may still need manual cleanup. Empty or omitted when all teardowns succeeded.
    - `connectorID` string — Populated for update/delete failures.
    - `name` string — Populated for create failures.
    - `operation` 'create' | 'update' | 'delete', required — Which diff operation was attempted.
    - `message` string, required — Human-readable error message.
    - `code` string, required — Machine-readable error code.

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)