Delete a workspace (two-step; ?confirm=true)

curl --request DELETE \
  --url https://origami.chat/api/v2/workspaces/{workspaceId} \
  --header 'Authorization: Bearer <token>'

{
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "confirmationRequired": true,
  "willDelete": {
    "tables": 123,
    "rows": 123
  }
}

Workspaces

Delete a workspace (two-step; ?confirm=true)

Permanently deletes a workspace and its entire entity tree (tables, rows, cells, sequences, chat history, documents). Follows the v2 deletes convention — deliberately two-step so it can’t fire on a single ambiguous instruction:

Call without ?confirm=true → no deletion. Returns HTTP 200 with the impact preview { workspaceId, name, confirmationRequired: true, willDelete: { tables, rows } }. The caller is expected to check with the user before proceeding.
After the user agrees, retry with ?confirm=true → performs the cascade soft-delete and returns { workspaceId, name, deleted: true }.

A missing / cross-org / already-deleted workspace returns 404 WORKSPACE_NOT_FOUND.

DELETE

workspaces

{workspaceId}

Delete a workspace (two-step; ?confirm=true)

curl --request DELETE \
  --url https://origami.chat/api/v2/workspaces/{workspaceId} \
  --header 'Authorization: Bearer <token>'

{
  "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "confirmationRequired": true,
  "willDelete": {
    "tables": 123,
    "rows": 123
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId

string<uuid>

required

Query Parameters

confirm

boolean

default:false

Must be true to actually delete. Omit for the impact preview.

Response

The impact preview (unconfirmed) or the delete receipt (confirmed).

Option 1
Option 2

Impact preview returned by DELETE /workspaces/{workspaceId} when ?confirm=true is absent. Nothing has been removed.

workspaceId

string<uuid>

required

name

string

required

confirmationRequired

boolean

required

willDelete

object

required

Show child attributes

Get workspace List documents