Skip to main content

​
delete_mode

Permanently deletes a mode and all tokens within it. Cannot delete the last mode in a tokenset.

​
Tool Schema

{
  "name": "delete_mode",
  "description": "Delete a mode and all its tokens (cannot delete the last mode in a tokenset)",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset"
      },
      "mode_id": {
        "type": "string",
        "description": "The ID of the mode to delete"
      }
    },
    "required": ["tokenset_id", "mode_id"]
  }
}

​
Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset containing the mode
mode_idstringYesThe ID of the mode to delete

​
Response

{
  "message": "Mode deleted successfully"
}

​
Example Usage in Claude

​
Delete a Mode

You: Delete the "Experimental" mode from tokenset 550e8400-e29b-41d4-a716-446655440010

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

Are you sure you want to delete the "Experimental" mode? This will also delete:
- 15 tokens in this mode

This action cannot be undone.

​
Confirm Deletion

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

Claude: Deleting mode "Experimental"...

Mode deleted successfully. All tokens in this mode have been permanently removed.

​
Common Use Cases

​
1. Cleanup Unused Themes

You: Remove the old "Blue Theme" mode that we're not using anymore

​
2. Simplify Design System

You: Delete the "Seasonal" mode after the campaign ended

​
3. Consolidate Modes

You: Remove duplicate or experimental modes

​
Restrictions

⚠️ Cannot delete the last mode: Every tokenset must have at least one mode. If you try to delete the only mode in a tokenset, the operation will fail.

​
Checking Before Deletion

Before deleting a mode, consider:
  1. Is this the only mode in the tokenset?
  2. Are there important tokens in this mode?
  3. Is this mode referenced elsewhere?

​
Warnings

⚠️ Destructive Action: This operation cannot be undone. When you delete a mode, you also permanently delete:
  • All tokens within that mode
  • Any token relationships or aliases specific to that mode

​
Best Practices

  1. Export data first: Consider exporting tokens before deletion
  2. Check token count: Review what tokens exist in the mode
  3. Team communication: Notify team members before deleting shared modes
  4. Verify it’s not the default: Make sure you’re not deleting the default mode

​
Notes

  • This action is permanent and cannot be reversed
  • All tokens in the mode are completely removed
  • The tokenset structure remains intact
  • Mode IDs are not reusable after deletion
  • If you delete the default mode, another mode will automatically become default

​
See Also