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

# Create Tier

> Add a tier to your workspace's ranking

See [Tiers](/tiers) for what a tier means and how it feeds fit grading.

## Body

<ParamField body="name" type="string" required>
  1-50 characters. A name your workspace already uses is rejected.
</ParamField>

<ParamField body="position" type="integer">
  Rank, 0 = highest, and the ranks are dense: a workspace with three tiers uses
  0, 1, 2. Omit it to place the tier last. There is no reorder route on this
  API, so an explicit position that collides with an existing tier can only be
  corrected by another write: prefer omitting it.
</ParamField>

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

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

  ```json 400 theme={null}
  {
    "success": false,
    "error": { "message": "a tier with this name already exists", "code": "BAD_REQUEST" }
  }
  ```
</ResponseExample>