---
title: "Update a keyword"
description: "Mute or unmute it, reclassify it (`kind`), change the platforms it is tracked on, its classifier `context`, or its `matching` rules (each rule field optional; an empty list clears one). Rules apply to new mentions from the next poll; stored mentions are untouched."
canonical: https://docs.mentio.dev/api/keywords/update-keyword
markdown: https://docs.mentio.dev/api/keywords/update-keyword.mdx
---

# Update a keyword

`PATCH /v1/keywords/{id}`

Mute or unmute it, reclassify it (`kind`), change the platforms it is tracked on, its classifier `context`, or its `matching` rules (each rule field optional; an empty list clears one). Rules apply to new mentions from the next poll; stored mentions are untouched.

## Parameters

- `id` (path, required): Keyword id (kw_...).

## Body

- `kind`: Reclassify it as brand, competitor or topic.
- `muted`: A muted keyword stops polling and matching; its mentions stay.
- `platforms`: Replaces the platform list; null means every platform.
- `context`: A sentence the classifier reads for this keyword only, on top of the company profile (at most 300 characters): what the term means here, what to ignore. "Arc is our browser; ignore the geometry word." Null clears it.
- `matching`: Omitted fields are untouched; an empty list clears one.

## Responses

- 200: The updated keyword
- 401: Missing or invalid API key
- 402: Unmuting needs balance for one more keyword-day (insufficient_balance) or would exceed the 500-keyword ceiling (keyword_limit_reached)
- 404: Keyword not found

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx