Documentation Index
Fetch the complete documentation index at: https://docs.tokencraft.dev/llms.txt
Use this file to discover all available pages before exploring further.
update_token
Updates the properties of an existing design token.
{
"name": "update_token",
"description": "Update a token",
"inputSchema": {
"type": "object",
"properties": {
"tokenset_id": {
"type": "string",
"description": "The ID of the tokenset"
},
"mode_id": {
"type": "string",
"description": "The ID of the mode"
},
"token_id": {
"type": "string",
"description": "The ID of the token to update"
},
"name": {
"type": "string",
"minLength": 1,
"description": "The new name of the token"
},
"type": {
"type": "string",
"enum": [
"color", "dimension", "fontFamily", "fontWeight", "fontSize",
"lineHeight", "letterSpacing", "duration", "cubicBezier",
"number", "strokeStyle", "border", "transition", "shadow",
"gradient", "typography", "string", "boolean"
],
"description": "The new type of the token"
},
"value": {
"type": "string",
"description": "The new value of the token"
},
"description": {
"type": "string",
"description": "The new description of the token"
},
"alias_to": {
"type": "string",
"description": "The new alias target"
}
},
"required": ["tokenset_id", "mode_id", "token_id"]
}
}
Parameters
| Parameter | Type | Required | Description |
|---|
tokenset_id | string | Yes | The ID of the tokenset |
mode_id | string | Yes | The ID of the mode |
token_id | string | Yes | The ID of the token to update |
name | string | No | The new name of the token |
type | string | No | The new token type |
value | string | No | The new value of the token |
description | string | No | The new description of the token |
alias_to | string | No | The new alias target (set to null to remove alias) |
Response
{
"id": "550e8400-e29b-41d4-a716-446655440035",
"name": "color.brand.primary",
"type": "color",
"value": "#0066CC",
"description": "Updated primary brand color - darker for better contrast",
"alias_to": null,
"mode_id": "550e8400-e29b-41d4-a716-446655440020",
"tokenset_id": "550e8400-e29b-41d4-a716-446655440010",
"created_at": "2025-01-15T13:00:00Z",
"updated_at": "2025-01-20T19:15:00Z"
}
Example Usage in Claude
Update Token Value
You: Change the primary color from #007AFF to #0066CC
Claude: I'll update the token value to the new color.
Token updated successfully:
- **Name**: color.primary
- **Old Value**: #007AFF
- **New Value**: #0066CC ✓
- **Description**: Updated primary brand color - darker for better contrast
Update Token Name and Description
You: Rename color.primary to color.brand.primary and update its description
Claude: I'll update both the name and description of the token.
Token updated successfully:
- **Name**: color.brand.primary (updated)
- **Description**: Primary brand color for all brand touchpoints (updated)
Convert to Alias
You: Make color.secondary an alias of color.primary
Claude: I'll convert this token to an alias that references the primary color.
Token updated successfully:
- **Name**: color.secondary
- **Type**: color
- **Value**: (alias)
- **Alias To**: color.primary
- **Resolved Value**: #0066CC
Remove Alias
You: Remove the alias from color.accent so it has its own value
Claude: I'll remove the alias and set a direct value for this token.
Token updated successfully:
- **Name**: color.accent
- **Alias To**: (removed)
- **Value**: #FF9500 (direct value)
Common Use Cases
1. Brand Updates
You: Update the brand colors to match the new brand guidelines
2. Token Renaming
You: Rename tokens to follow the new naming convention
3. Value Adjustments
You: Adjust spacing values for better visual hierarchy
4. Alias Management
You: Convert direct tokens to aliases for better maintainability
Important Notes
- At least one update parameter must be provided
- Token names must be unique within their mode
- Changing
alias_to will automatically resolve the token’s value
- The
updated_at timestamp is automatically updated
- Type changes may require value format changes
See Also