> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowmaticai.in/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE /api/workflows/:workflowId — Delete a Workflow

> DELETE /api/workflows/:workflowId — Permanently delete a workflow by ID, removing its full definition and all associated run history from your account.

If you no longer need a workflow, you can permanently remove it from your account using the delete endpoint. Submitting a `DELETE` request with the target workflow's ID instructs Flowmatic to remove the workflow definition and every run record associated with it. This helps you keep your account tidy and ensures that stale workflows are not accidentally triggered.

## Endpoint

```
DELETE https://api.flowmatic.io/api/workflows/:workflowId
```

**Authentication:** `Authorization: Bearer <accessToken>` header required.\
**Request body:** None.

<Warning>
  Deletion is permanent and cannot be undone. When you delete a workflow, Flowmatic removes not only the workflow definition but also the complete run history for that workflow. All logs, output records, and execution details associated with past runs are destroyed. Make sure you no longer need any of this data before proceeding.
</Warning>

## Path Parameters

<ParamField path="workflowId" type="string" required>
  The unique ID of the workflow you want to permanently delete. You can retrieve this value from the [List Workflows](/api-reference/workflows/list) or [Get Workflow](/api-reference/workflows/get) endpoints.
</ParamField>

## Example Request

Replace `:workflowId` with the ID of the workflow you want to delete:

```bash theme={null}
curl -X DELETE https://api.flowmatic.io/api/workflows/wf_7kQmR9pL2x \
  -H "Authorization: Bearer <accessToken>"
```

## Response

A successful deletion returns HTTP `204 No Content`. The response body is empty. If the workflow ID does not exist or does not belong to your account, the API returns `404 Not Found`.

### Example Response

```
HTTP/1.1 204 No Content
```