Delete Keyword
delete_keywordPermanently delete a keyword and all its mentions when you need to remove it from monitoring and free an active plan slot; this cannot be undone.
Instructions
Permanently delete one keyword in any status, together with every mention it produced. There is no undo and no restore: disable_keyword pauses a keyword and keeps its mentions, edit_keyword fixes a SUSPENDED value, and delete_website drops a whole site. Deleting an active keyword frees a plan slot, so the oldest pending keyword that now fits the plan may become active, which queues public-network searches and ranking checks; this tool does not issue a refund or change the subscription. Confirm with the user first and name the keyword, not just the ID. Returns { deleted: true }; 404 if the ID is unknown to this account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keywordId": "<keywordId>"
},
"name": "delete_keyword"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywordId | Yes | ID of the keyword to erase, from the keywords list in list_websites or get_website | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace do not exist in another |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |