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

Parameter	Type	Required	Description
`tokenset_id`	string	Yes	The ID of the tokenset containing the mode
`mode_id`	string	Yes	The 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:

Is this the only mode in the tokenset?
Are there important tokens in this mode?
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

Export data first: Consider exporting tokens before deletion
Check token count: Review what tokens exist in the mode
Team communication: Notify team members before deleting shared modes
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

​delete_mode

​Tool Schema

​Parameters

​Response

​Example Usage in Claude

​Delete a Mode

​Confirm Deletion

​Common Use Cases

​1. Cleanup Unused Themes

​2. Simplify Design System

​3. Consolidate Modes

​Restrictions

​Checking Before Deletion

​Warnings

​Best Practices

​Notes

​See Also