Sign in
Workspaces

Delete a workspace

Delete an existing workspace. Workspaces with active API keys cannot be deleted; remove the keys first. Deleting the default workspace requires confirm_default_workspace_deletion=true. Deleting any workspace permanently deletes its budgets and guardrails and disables its classifiers and broadcast destinations. Management key required.

delete/workspaces/{id}

Path parameters

idstring required

The workspace ID (UUID) or slug

Example:production

The workspace ID (UUID) or slug

Query parameters

confirm_default_workspace_deletion'true' | 'false'

Required to delete the default workspace. Deleting it permanently disables the account’s unscoped inference API keys (management/provisioning keys are retained) and its budgets, guardrails, classifiers, and broadcast destinations. Ignored for non-default workspaces.

Example:false

Required to delete the default workspace. Deleting it permanently disables the account’s unscoped inference API keys (management/provisioning keys are retained) and its budgets, guardrails, classifiers, and broadcast destinations. Ignored for non-default workspaces.

Response

Workspace deleted successfully

deletedtrue required

Confirmation that the workspace was deleted

Example response

{
  "deleted": true
}

Changes

Changed in 3 of the 303 revisions of this API.12

  • 1aed4823fa6d1See the full diff
    • ○

      added the new optional query request parameter confirm_default_workspace_deletion

      new-optional-request-parameter

  • e1c24a83149d1See the full diff
    • ●

      deleted the query request parameter confirm_default_settings_deletion

      request-parameter-removed

  • 868606d7c31b1See the full diff
    • ○

      added the new optional query request parameter confirm_default_settings_deletion

      new-optional-request-parameter