v1

latestOpenAPI 3.1.02026-07-267154122.0 KB
Workspace

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:

  1. Call without ?confirm=trueno 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.
  2. 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}

Query parameters

confirmboolean

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

Response

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

OR