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

# delete_tokenset

> Delete a tokenset and all its associated modes and tokens

# delete\_tokenset

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

## Tool Schema

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

| Parameter     | Type   | Required | Description                      |
| ------------- | ------ | -------- | -------------------------------- |
| `tokenset_id` | string | Yes      | The ID of the tokenset to delete |

## Response

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

* [list\_tokensets](/mcp/tools/list-tokensets) - View all tokensets before deletion
* [get\_tokenset](/mcp/tools/get-tokenset) - Check tokenset details and contents
* [export\_tokenset](/mcp/tools/export-tokens) - Export tokens before deletion