---
title: "Remove a competitor"
method: DELETE
path: "/entities/{entityId}"
tags: ["entities"]
---

# Remove a competitor

`DELETE /entities/{entityId}`

## Request

- Base URL: `https://shruwd.io/api/v1`
- URL: `https://shruwd.io/api/v1/entities/{entityId}`
- Auth: HTTP bearer

Closes the entity and its rows as of now. The self entity cannot be removed (`409 self_entity`); archive the brand instead.

## Response `200`

Removed.

- object
  - `entityId` string, required
  - `removed` true, required

## Other responses

- `404`: `not_found`: no such resource in this workspace.
- `409`: `self_entity`.
- `default`: Every failure has this body.

---

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