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

> Delete a token from a mode

# delete\_token

Permanently deletes a design token from a specific mode.

## Tool Schema

```json theme={null}
{
  "name": "delete_token",
  "description": "Delete 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 delete"
      }
    },
    "required": ["tokenset_id", "mode_id", "token_id"]
  }
}
```

## Parameters

| Parameter     | Type   | Required | Description                                 |
| ------------- | ------ | -------- | ------------------------------------------- |
| `tokenset_id` | string | Yes      | The ID of the tokenset containing the token |
| `mode_id`     | string | Yes      | The ID of the mode containing the token     |
| `token_id`    | string | Yes      | The ID of the token to delete               |

## Response

```json theme={null}
{
  "message": "Token deleted successfully"
}
```

## Example Usage in Claude

### Delete a Token

```
You: Delete the old color.accent token from the Light mode

Claude: I need to confirm this action since it will permanently delete the token.

Are you sure you want to delete the token "color.accent" with value "#FF9500"? This action cannot be undone.
```

### Confirm Deletion

```
You: Yes, I'm sure. Delete it.

Claude: Deleting token "color.accent"...

Token deleted successfully.
```

## Common Use Cases

### 1. Token Cleanup

```
You: Remove unused or deprecated tokens from the design system
```

### 2. Brand Changes

```
You: Delete old brand colors that are no longer part of the palette
```

### 3. System Simplification

```
You: Remove experimental tokens that didn't work out
```

## Warnings

⚠️ **Destructive Action**: This operation cannot be undone.

When you delete a token, consider:

* Is this token referenced by aliases in other tokens?
* Is this token used in exported designs or code?
* Will this break any existing implementations?

### Best Practices

1. **Check dependencies**: Search for tokens that might reference this one
2. **Export backup**: Consider exporting before deletion
3. **Team communication**: Notify team members before deleting shared tokens
4. **Gradual removal**: Mark as deprecated first, then delete later

## Notes

* This action is permanent and cannot be reversed
* Only deletes the token from the specific mode (other modes keep their versions)
* Token IDs are not reusable after deletion
* Aliases pointing to this token will need to be updated

## Mode-Specific Deletion

Tokens are mode-specific, so deleting a token from one mode doesn't affect:

* The same token name in other modes
* Other tokens in the same mode
* The token structure or relationships

## See Also

* [list\_tokens\_by\_mode](/mcp/tools/list-tokens-by-mode) - View tokens before deletion
* [get\_token](/mcp/tools/get-token) - Check token details
* [search\_tokens](/mcp/tools/search-tokens) - Find references to this token
* [export\_mode](/mcp/tools/export-mode) - Export tokens before deletion