# update_tag (/docs/mcp/tools/update-tag)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/update_tag.mdx. */}

**Update a tag** · Changes data

Renames a tag or changes its colour on this website. Every lead that has the tag keeps it. Pass only what changes. tagId comes from list_tags.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites. |
| `tagId` | `string` | Yes | Tag ID from list_tags. |
| `name` | `string` | No | New tag name. |
| `color` | `string` | No | New colour as a hex code, e.g. #1E4EFF. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "update_tag",
  "title": "Update a tag",
  "annotations": {
    "title": "Update a tag",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "tagId": {
        "type": "string",
        "description": "Tag ID from list_tags."
      },
      "name": {
        "type": "string",
        "description": "New tag name."
      },
      "color": {
        "type": "string",
        "description": "New colour as a hex code, e.g. #1E4EFF."
      }
    },
    "required": [
      "websiteId",
      "tagId"
    ]
  }
}
```