Appearance
Delete Keyword
DELETE
/v2/organizations/{organizationId}/keywords/{keywordId}Deleting a keyword destroys its mentions
Deleting a keyword also deletes every mention collected under it. Those mentions cannot be recovered.
The keyword's setup — its name, query and filters — may still be restorable. If you deleted a keyword by mistake, contact support promptly: the configuration may come back, but the mentions will not.
Parameters
Path Parameters
organizationIdintegerrequiredpathThe unique identifier of the organization (int64).
keywordIdintegerrequiredpathThe unique identifier of the keyword to delete (int32).
Try it
Parameters
Organization ID
ID of the keyword to delete
Response
A successful delete returns 200 OK with an empty response body — there is no JSON payload. Clients that parse every response as JSON need to handle the empty case.
Errors
| Status | Description |
|---|---|
404 Not Found | No keyword with the given ID exists in this organization, or it has already been deleted |
Deleting the same keyword twice returns 404 on the second call, not 200. Retry logic that treats a delete as safely repeatable should accept 404 as "already gone".
See the Errors & Rate Limits page for the full error response structure.