> ## 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_tokenset

> Update an existing tokenset name or description

# update\_tokenset

Updates the name or description of an existing tokenset.

## Tool Schema

```json theme={null}
{
  "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

| Parameter     | Type   | Required | Description                                     |
| ------------- | ------ | -------- | ----------------------------------------------- |
| `tokenset_id` | string | Yes      | The ID of the tokenset to update                |
| `name`        | string | No       | The new name of the tokenset (1-255 characters) |
| `description` | string | No       | The new description of the tokenset             |

## Response

```json theme={null}
{
  "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

* [get\_tokenset](/mcp/tools/get-tokenset) - Get tokenset details
* [list\_tokensets](/mcp/tools/list-tokensets) - View all tokensets in workspace
* [create\_tokenset](/mcp/tools/create-tokenset) - Create new tokenset