---
title: "POST /v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept"
method: POST
path: "/v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept"
tags: ["competitor-suggestions"]
---

# POST /v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept

`POST /v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required
- `candidate_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

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