Skip to main content
DELETE
Delete a workspace (two-step; ?confirm=true)

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

Deprecated container id: a legacy workspace id OR a chat-session id (the session-container form is what v2 returns for new agents). Both resolve everywhere this parameter appears.

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).

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