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

> Update a competitor's details, or pause and resume monitoring

Update a competitor's details or status. Send only the fields you want to change.

Set `status` to `paused` to stop monitoring without deleting the competitor; paused competitors free their slot. Flipping `paused` back to `active` is subject to the slot limit and returns `409` when full.

## Path

<ParamField path="id" type="string" required>
  Competitor ID.
</ParamField>

## Body

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

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

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

<ParamField body="status" type="string">
  `active` or `paused`.
</ParamField>

<RequestExample>
  ```bash Pause theme={null}
  curl -X PATCH https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890 \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "status": "paused" }'
  ```

  ```bash Rename theme={null}
  curl -X PATCH https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890 \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "company_name": "Globex Corporation" }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "company_name": "Globex Inc",
      "domain": "globex.com",
      "linkedin_url": "https://www.linkedin.com/company/globex",
      "status": "paused",
      "created_at": "2026-06-30T09:00:00Z",
      "updated_at": "2026-06-30T10:42:00Z"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "Competitor not found", "code": "NOT_FOUND" }
  }
  ```

  ```json 409 theme={null}
  {
    "success": false,
    "error": {
      "message": "Competitor monitoring slot limit reached",
      "code": "CONFLICT"
    }
  }
  ```
</ResponseExample>