Skip to main content

​
delete_workspace

Permanently deletes a workspace and all its contents including tokensets, modes, and tokens.

​
Tool Schema

{
  "name": "delete_workspace",
  "description": "Delete a workspace and all its associated tokensets, modes, and tokens",
  "inputSchema": {
    "type": "object",
    "properties": {
      "workspace_id": {
        "type": "string",
        "description": "The ID of the workspace to delete"
      }
    },
    "required": ["workspace_id"]
  }
}

​
Parameters

ParameterTypeRequiredDescription
workspace_idstringYesThe ID of the workspace to delete

​
Response

{
  "message": "Workspace deleted successfully"
}

​
Example Usage in Claude

​
Delete a Workspace

You: Delete the workspace with ID 550e8400-e29b-41d4-a716-446655440000

Claude: I need to confirm this action since it will permanently delete the workspace and all its contents.

Are you sure you want to delete the workspace "Old Project"? This will also delete:
- 3 tokensets
- All modes and tokens within those tokensets

This action cannot be undone.

​
Confirm Deletion

You: Yes, I'm sure. Delete it.

Claude: Deleting workspace "Old Project"...

Workspace deleted successfully. All associated tokensets, modes, and tokens have been permanently removed.

​
Common Use Cases

​
1. Project Cleanup

You: Clean up old prototype workspaces that are no longer needed

​
2. Archive Old Work

You: Remove workspaces for completed client projects

​
3. Organization

You: Delete duplicate or unused workspaces

​
Warnings

⚠️ Destructive Action: This operation cannot be undone. When you delete a workspace, you also permanently delete:
  • All tokensets within the workspace
  • All modes within those tokensets
  • All tokens within those modes
  • Any associated token relationships or aliases

​
Best Practices

  1. Export data first: Consider exporting important tokens before deletion
  2. Confirm contents: Check what tokensets exist in the workspace before deleting
  3. Team communication: Notify team members before deleting shared workspaces

​
Notes

  • This action is permanent and cannot be reversed
  • All data associated with the workspace is completely removed from the system
  • Workspace IDs are not reusable after deletion

​
See Also