Skip to main content

​
update_mode

Updates the name or default status of an existing mode.

​
Tool Schema

{
  "name": "update_mode",
  "description": "Update a mode",
  "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 update"
      },
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "The new name of the mode"
      },
      "is_default": {
        "type": "boolean",
        "description": "Whether this mode should be the default mode"
      }
    },
    "required": ["tokenset_id", "mode_id"]
  }
}

​
Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset containing the mode
mode_idstringYesThe ID of the mode to update
namestringNoThe new name of the mode (1-255 characters)
is_defaultbooleanNoWhether this mode should be the default mode

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440025",
  "name": "Dark Theme",
  "is_default": true,
  "tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
  "created_at": "2025-01-15T12:15:00Z",
  "updated_at": "2025-01-20T17:30:00Z"
}

​
Example Usage in Claude

​
Update Mode Name

You: Rename mode 550e8400-e29b-41d4-a716-446655440025 to "Dark Theme"

Claude: I'll update the mode name to "Dark Theme".

Mode updated successfully:
- **Name**: Dark Theme (updated)
- **Default**: Now default ✓

​
Change Default Mode

You: Make the Dark mode the default in my color tokenset

Claude: I'll change the default mode to Dark. The previous default mode will become non-default.

Mode updated successfully:
- **Name**: Dark
- **Default**: Yes ✓ (changed from Light)

​
Update Both Name and Default Status

You: Change mode 550e8400-e29b-41d4-a716-446655440025 to "Night Mode" and make it default

Claude: I'll update both the name and default status of the mode.

Mode updated successfully:
- **Name**: Night Mode (updated)
- **Default**: Yes ✓ (changed)

​
Common Use Cases

​
1. Better Naming

You: Rename "Dark" to "Dark Theme" for clarity

​
2. Theme Switching

You: Make Dark mode the default theme

​
3. Reorganization

You: Change "HC" to "High Contrast" mode

​
Default Mode Behavior

  • Setting is_default: true will automatically change any other default mode to non-default
  • Each tokenset can have only one default mode
  • The default mode is used when no specific mode is requested
  • You cannot remove the default status from a mode if it’s the only mode in the tokenset

​
Notes

  • At least one of name or is_default must be provided
  • Mode names must be unique within their tokenset
  • The updated_at timestamp will be automatically updated
  • All existing tokens within the mode remain unchanged

​
See Also