---
title: "Remove a competitor"
method: DELETE
path: "/api/admin/brand-competitors/{id}"
tags: ["Brand Competitors"]
---

# Remove a competitor

`DELETE /api/admin/brand-competitors/{id}`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/admin/brand-competitors/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/admin/brand-competitors/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Marks the competitor as removed by an admin. The row is kept, hidden from the list and the profile, so the name stays on record. For a linked competitor the synonym written for its name is removed, unless another competitor still links that name to the same brand, or the synonym was added by hand or by another pipeline. Requires approve-company permission.

## Path parameters

- `id` integer, required

## Response `204`

Competitor removed.

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `404`: Competitor not found, or already removed

---

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