> ## 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 Opportunity Status

> Rename, recolour, move, or retag a status

<Warning>
  **Deprecated — a status is a [tag](/tags).** Use [Update
  Tag](/api-reference/update-tag): a status id is that tag's id, and
  `is_terminal` is the tag's `closes`.
</Warning>

Only provided fields change. This updates the tag itself — to change what a
path carries, see [Set An Opportunity's
Tags](/api-reference/set-path-record-tags).

## Path Parameters

<ParamField path="id" type="string" required>
  Status UUID.
</ParamField>

## Body

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

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

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

<ParamField body="is_terminal" type="boolean" />

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/opportunity-statuses/5e6f7a8b-..." \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"is_terminal": true}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "id": "5e6f7a8b-...",
      "name": "Meeting booked",
      "is_terminal": true
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
  }
  ```
</ResponseExample>