---
title: "Delete one or more tracked keywords"
method: POST
path: "/v3/rank-tracking/keywords/delete"
tags: ["Rank Tracking"]
---

# Delete one or more tracked keywords

`POST /v3/rank-tracking/keywords/delete`

Permanently delete tracked keyword(s) and their rank history by ID or list of IDs. The shared keyword entity and any topic-cluster membership are left intact. Unlike untrack, this cannot be undone.

## Request body

- union
  - object
    - `teamId` string — Team ID
    - `id` string, required — Single tracked keyword ID
    - `ids` string[] — Multiple tracked keyword IDs
  - object
    - `teamId` string — Team ID
    - `id` string — Single tracked keyword ID
    - `ids` string[], required — Multiple tracked keyword IDs

## Response `200`

Default Response

- object
  - `success` boolean
  - `deleted` number

## Other responses

- `400` — Default Response
- `409` — Default Response
- `500` — Default Response

## Changes

- **2026-08-30** `86840800b2f3` — 1 info
  - added the non-success response with the status `409`
- **2026-07-26** `60ff6690f93c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/rank-tracking/keywords/delete/post.md)

---

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