---
title: "Delete a workflow"
method: DELETE
path: "/api/v3/workflows/{workflowId}"
tags: ["V3 Workflows"]
---

# Delete a workflow

`DELETE /api/v3/workflows/{workflowId}`

Permanently deletes a workflow by id. Deletion cascades to the workflow's versions, runs,
and run logs so no response-derived data is left behind (GDPR requirement). This is
irreversible; use `POST /api/v3/workflows/{workflowId}/archive` for a reversible
soft-delete that keeps history. Returns `204 No Content`.

## Path parameters

- `workflowId` string, cuid2, required

## Response `204`

Workflow deleted successfully

## Other responses

- `400` — Bad Request — malformed JSON, invalid query/body/params, duplicate name, or unsupported field.
- `401` — Not authenticated (no valid session or API key).
- `403` — Forbidden — no workspace access, or resource does not exist (404 not used; avoids existence leak).
- `429` — Rate limit exceeded.
- `500` — Internal Server Error.

---

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