> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Account Tag

> Rename, recolour or reorder a tag

Every field is optional, and an omitted field is left alone — a client that does
not know about a field yet cannot clear it by not sending it.

Renaming a tag does not break anything: assignments, filters and saved views all
reference the tag's **id**, never its name.

## Path Parameters

<ParamField path="id" type="string" required>
  The tag's id, from [List Account Tags](/api-reference/list-account-tags).
</ParamField>

## Body

<ParamField body="name" type="string">1-50 characters, unique in your workspace.</ParamField>
<ParamField body="color" type="string">A hex colour.</ParamField>
<ParamField body="position" type="integer">Display position.</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/account-tags/7f3e1a22-..." \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Shared investor"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "tag": { "id": "7f3e1a22-...", "name": "Shared investor", "color": "#3B82F6", "position": 4 }
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "Account tag not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>