---
title: "Replace brand competitors"
method: PATCH
path: "/v3/settings/brand/competitors"
tags: ["Settings"]
---

# Replace brand competitors

`PATCH /v3/settings/brand/competitors`

Full replace of the team's competitor list. Each entry needs name + website; may include an existing id to update in place. active defaults to true, ignored to false. Sending an empty array clears all competitors.

## Request body

- object
  - `teamId` string
  - `competitors` object[]
    - `id` string
    - `name` string, required
    - `website` string, required
    - `active` boolean
    - `ignored` boolean

## Response `200`

Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/versions/6e50f4761eea/schema)