---
title: "PATCH /v1/projects/{project_id}/competitors/{competitor_id}"
method: PATCH
path: "/v1/projects/{project_id}/competitors/{competitor_id}"
tags: ["competitors"]
---

# PATCH /v1/projects/{project_id}/competitors/{competitor_id}

`PATCH /v1/projects/{project_id}/competitors/{competitor_id}`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/competitors/{competitor_id}`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required
- `competitor_id` string, uuid, required

## Request body

- object
  - `name` string
  - `aliases` string[]
  - `domains` string[]

## Response `200`

Successful Response

- Competitor
  - `id` string, uuid, required
  - `name` string, required
  - `aliases` string[], required
  - `domains` string[], required
  - `logo_url` string, nullable
  - `matching` EntityMatching
    - `mode` 'always' | 'context_required', required
    - `context_terms` string[], required
    - `exclusion_phrases` string[], required
    - `common_word` boolean, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)