Account

Delete a workspace

Hard-delete a workspace and everything in it.

Requires ADMIN role in the workspace (the write service decides); a workspace outside the caller's memberships is a 403, as on the update. The cascade removes every project, its data references, access keys, memberships and invites; the typed name must equal the workspace's current name, and the caller's only workspace cannot be deleted.

Args: request (Request): Incoming request (rate-limit plumbing). response (Response): Outgoing response (rate-limit plumbing). auth (AccountStampedAuth): Account-scope user auth (session token or CLI access JWT); its resolved user_id becomes the actor. workspace_id (str): The workspace to delete. name (str): The workspace's current name, as a typed confirmation. reason (str): Why it is being deleted; recorded on the audit row. _live (None): Write-path liveness gate (blocks a revoked JWT session).

Returns: DeleteWorkspaceResponse: The removed workspace and the cascade counts.

Raises: HTTPException: The write service's 400/403/404/409 verbatim, or a 503 when its response is ambiguous.

delete/api/v1/public/workspaces/{workspace_id}

Request

  • Base URL
    https://app.traceroot.ai
  • URL
    https://app.traceroot.ai/api/v1/public/workspaces/{workspace_id}
  • Auth
    HTTP bearer

Path parameters

workspace_idstring required

Query parameters

namestring required

The workspace's current name, typed as confirmation

reasonstring required

Why the resource is being deleted; recorded on the audit row

Response

Successful Response

cascadedobject nullable
deletedboolean required
reasonstring required

Changes

No recorded changes to this operation across all 1 revision of this API.