---
title: "Legacy alias: delete a workspace (body-confirm protocol)"
method: POST
path: "/workspaces/{workspaceId}/delete"
tags: ["Workspace"]
deprecated: true
---

# Legacy alias: delete a workspace (body-confirm protocol)

`POST /workspaces/{workspaceId}/delete`

> **Deprecated.**

Deprecated alias for `DELETE /workspaces/{workspaceId}`. Keeps the
original body-confirm protocol: with `confirm` omitted/false it
returns `409 CONFIRMATION_REQUIRED` whose `details` carry the
workspace name and the `willDelete: { tables, rows }` impact preview;
the `{ "confirm": true }` retry performs the delete and returns
`{ workspaceId, name, deleted: true }`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `confirm` boolean — Must be true to actually delete. Omit/false to get the confirmation preview.

## Response `200`

{ workspaceId, name, deleted: true } — workspace deleted.

## Other responses

- `404` — WORKSPACE_NOT_FOUND.
- `409` — CONFIRMATION_REQUIRED — details carry name + willDelete preview; retry with { confirm: true }.

---

[API](https://skmtc.net/origami/apis/origami-agent-api.md) · [All operations](https://skmtc.net/origami/apis/origami-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/origami/origami-agent-api/versions/8083ad7fe081/schema)