---
title: "Delete a workflow"
method: DELETE
path: "/workflows/{workflow_id}"
tags: ["workflows"]
---

# Delete a workflow

`DELETE /workflows/{workflow_id}`

Deletes a workflow. Org-scoped — workflows in other orgs return 404.

## Path parameters

- `workflow_id` string, uuid, required — workflow identifier

## Response `200`

OK

- MessageOutputBody — Simple confirmation message.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `message` string, required — Human-readable result message.

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

> 18 revisions in range; 4 could not be searched.

- **2026-08-17** `e2261ff54e62` — 4 info
  - the endpoint scheme security `bearerAuth` was removed from the API
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
- **2026-07-23** `5a989777701c` — 1 breaking
  - for the `path` request parameter `workflow_id`, the type/format was changed from `string`/`` to `string`/`uuid`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/workflows/:workflow_id/delete.md)

---

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