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

> Rename a tier or move it in rank

Only provided fields change. Reordering re-ranks every account carrying a
tier, not just this one — see [Tiers](/tiers).

## Path Parameters

<ParamField path="id" type="string" required>
  The tier's id.
</ParamField>

## Body

<ParamField body="name" type="string" />

<ParamField body="position" type="integer" />

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/tenant-tiers/1a2b3c4d-..." \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"position": 0}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": { "id": "1a2b3c4d-...", "name": "Strategic", "position": 0 }
  }
  ```

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