Workspaces / MCP

Delete workspace

Permanently delete one exact workspace owned by the authenticated personal-token user. Requires confirm=true. This cannot be undone.

tools/callDeterministic operation

Parameters

workspaceIdOptional · string
Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.
targetWorkspaceIdRequired · string
Exact workspace to delete. This is never replaced by the workspace selected for authentication.
confirmRequired · boolean
See the input schema for this field.
Request example
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete-workspace",
    "arguments": {
      "targetWorkspaceId": "00000000-0000-4000-8000-000000000000",
      "confirm": true
    }
  }
}
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1,
      "description": "Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client."
    },
    "targetWorkspaceId": {
      "type": "string",
      "description": "Exact workspace to delete. This is never replaced by the workspace selected for authentication."
    },
    "confirm": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "targetWorkspaceId",
    "confirm"
  ]
}
See this operation inCLI REST API TypeScript SDK
Tool directory | Pipeline v2 preview