Skip to main content

​
delete_tokenset

Permanently deletes a tokenset and all its contents including modes and tokens.

​
Tool Schema

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

​
Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset to delete

​
Response

{
  "message": "Tokenset deleted successfully"
}

​
Example Usage in Claude

​
Delete a Tokenset

You: Delete the tokenset with ID 550e8400-e29b-41d4-a716-446655440010

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

Are you sure you want to delete the tokenset "Old Colors"? This will also delete:
- 3 modes (Light, Dark, High Contrast)
- 25 tokens across all modes

This action cannot be undone.

​
Confirm Deletion

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

Claude: Deleting tokenset "Old Colors"...

Tokenset deleted successfully. All associated modes and tokens have been permanently removed.

​
Common Use Cases

​
1. Token Cleanup

You: Remove old or unused tokensets after design system updates

​
2. Restructure Organization

You: Delete tokensets that have been merged into others

​
3. Archive Old Work

You: Clean up prototype tokensets that are no longer needed

​
Warnings

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

​
Best Practices

  1. Export data first: Consider exporting the tokenset before deletion
  2. Check dependencies: Ensure no other tokensets reference tokens from this one
  3. Team communication: Notify team members before deleting shared tokensets

​
Notes

  • This action is permanent and cannot be reversed
  • All data associated with the tokenset is completely removed from the system
  • The parent workspace remains unaffected
  • Tokenset IDs are not reusable after deletion

​
See Also