---
title: "Delete Workflow"
method: DELETE
path: "/api/v1/workflows/{workflow_id}"
tags: ["Workflows"]
---

# Delete Workflow

`DELETE /api/v1/workflows/{workflow_id}`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/workflows/{workflow_id}`
- Auth: HTTP bearer

Permanently deletes a workflow and everything in it — all sheets, inputs, actions, rows, and run history. Cannot be undone.

Only the workflow owner can delete a workflow. Shared users and org members with workflow access cannot delete workflows they do not own.

## Path parameters

- `workflow_id` string, required

## Response `200`

Default Response

- object
  - `status` integer
  - `data` WorkflowDeleted: Confirmation envelope for a deleted workflow.
    - `workflow_id` string, uuid, required: UUID of the workflow that was deleted.
    - `deleted` boolean, required: Always `true` on a 200 response. Included so agents can branch on a single field.

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `404`: Workflow not found
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)