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

# Delete Competitor

> Remove a monitored competitor

Remove a monitored competitor and stop monitoring it. To keep the competitor but stop runs, [pause](/api-reference/update-competitor) it instead.

## Path

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  requests.delete(
      "https://api.clustr-ai.com/api/public/competitors/c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "message": "Competitor deleted successfully",
      "deleted_count": 1
    }
  }
  ```

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