Skip to main content

​
update_tokenset

Updates the name or description of an existing tokenset.

​
Tool Schema

{
  "name": "update_tokenset",
  "description": "Update a tokenset",
  "inputSchema": {
    "type": "object",
    "properties": {
      "tokenset_id": {
        "type": "string",
        "description": "The ID of the tokenset to update"
      },
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255,
        "description": "The new name of the tokenset"
      },
      "description": {
        "type": "string",
        "description": "The new description of the tokenset"
      }
    },
    "required": ["tokenset_id"]
  }
}

​
Parameters

ParameterTypeRequiredDescription
tokenset_idstringYesThe ID of the tokenset to update
namestringNoThe new name of the tokenset (1-255 characters)
descriptionstringNoThe new description of the tokenset

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "name": "Brand Colors",
  "description": "Updated description for brand color tokens",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2025-01-15T11:00:00Z",
  "updated_at": "2025-01-20T15:45:00Z"
}

​
Example Usage in Claude

​
Update Tokenset Name

You: Rename the tokenset 550e8400-e29b-41d4-a716-446655440010 to "Brand Colors"

Claude: I'll update the tokenset name to "Brand Colors".

Tokenset updated successfully:
- **Name**: Brand Colors (updated)
- **Description**: Updated description for brand color tokens

​
Update Tokenset Description

You: Update the description of tokenset 550e8400-e29b-41d4-a716-446655440010 to "Primary, secondary, and accent colors for the brand"

Claude: I'll update the tokenset description.

Tokenset updated successfully:
- **Name**: Brand Colors
- **Description**: Primary, secondary, and accent colors for the brand (updated)

​
Update Both Name and Description

You: Change tokenset 550e8400-e29b-41d4-a716-446655440010 to "Color Palette" with description "Complete color system including semantic colors"

Claude: I'll update both the name and description of the tokenset.

Tokenset updated successfully:
- **Name**: Color Palette (updated)
- **Description**: Complete color system including semantic colors (updated)

​
Common Use Cases

​
1. Better Naming

You: Rename "Colors" to "Brand Colors" for clarity

​
2. Updated Documentation

You: Update the tokenset description to reflect its current purpose

​
3. Organization Changes

You: Change "Components" to "Component Tokens" to be more specific

​
Notes

  • At least one of name or description must be provided
  • Tokenset names must be unique within their workspace
  • The updated_at timestamp will be automatically updated
  • All existing tokens and modes within the tokenset remain unchanged
  • The workspace association cannot be changed (create a new tokenset instead)

​
See Also