Workspaces

Delete a workspace

Changed on

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}

Request

  • Base URL: https://openrouter.ai/api/v1
  • URL: https://openrouter.ai/api/v1/workspaces/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The workspace ID (UUID) or slug

Example:production

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

Response

Workspace deleted successfully

deletedtrue required

Confirmation that the workspace was deleted

Example response

{
  "deleted": true
}

Changes