---
title: "Deletes the Niche"
method: DELETE
path: "/v1/niches/{nicheId}"
tags: ["v1"]
---

# Deletes the Niche

`DELETE /v1/niches/{nicheId}`

Deletes the specified Niche and all associated data including keywords, competitors, all dives and diveboxes. Note: A Niche cannot be deleted if it is used in any Rank Radar.

## Path parameters

- `nicheId` string, required

## Response `204`

Deleted

## Other responses

- `401` — Api key is invalid
- `403` — Unauthorized to access the resource
- `404` — Niche not found
- `409` — Niche cannot be deleted because it is used in a rank radar
- `429` — Rate limit exceeded, either the per-client-IP limit or the per-API-key limit for this endpoint.
- `500` — Internal error

---

[API](https://skmtc.dev/datadive/apis/data-dive-developer-apis.md) · [All operations](https://skmtc.dev/datadive/apis/data-dive-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadive/data-dive-developer-apis/revisions/03207abc96ba/schema)