---
title: "Update a competitor"
method: PATCH
path: "/competitors/{id}"
tags: ["Competitors"]
---

# Update a competitor

`PATCH /competitors/{id}`

Website domain/host and citation-rule changes share one seven-day cooldown per competitor; other fields remain editable during the cooldown.

## Path parameters

- `id` integer, required

## Request body

- object
  - `project_id` integer, required
  - `brand_name` string
  - `domain` string — Website domain or host used for citation matching; a full URL is accepted
  - `matching_names` string[]
  - `color` string
  - `citation_match_mode` 'domain' | 'host' | 'path_prefix'
  - `citation_match_path` string — Required when changing citation_match_mode to path_prefix

## Response `200`

Updated

## Other responses

- `403` — API key lacks write permission
- `404` — Resource not found
- `422` — Invalid parameters

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) · [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmpulse/llm-pulse-api/revisions/a3e61e246f23/schema)