---
title: "Update Competitor"
method: PATCH
path: "/radar/competitors/{competitor_id}"
tags: ["Radar"]
---

# Update Competitor

`PATCH /radar/competitors/{competitor_id}`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/radar/competitors/{competitor_id}`
- Auth: HTTP bearer

Update a competitor profile (tier, active flag, name, or scan_config).

## Path parameters

- `competitor_id` string, required

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- PatchCompetitorRequest
  - `tier` string, nullable
  - `is_active` boolean, nullable
  - `name` string, nullable
  - `scan_config` ScanConfigDTO: Per-competitor page-selection config (persisted on profile.meta.scan_config). mode=auto: Firecrawl /map → rank by traffic + pricing/feature paths → scrape top N (= tier page budget). mode=manual: scrape include_paths (literal or /wildcard/* patterns), capped to the budget.
    - `mode` 'auto' | 'manual'
    - `include_paths` string[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)