Edit Keyword
edit_keywordReplace a keyword's text while keeping its ID, re-grade it, and synchronize matching rules and alerts. Use it to correct or update tracked terms without losing keyword history or monitoring.
Instructions
Replace a keyword's text while keeping its ID. Edits are unlimited. The new value is re-graded and replaces its matching rules; an active keyword stays active, while other keywords become active only if the current plan has space. Activating a suspended keyword also queues public-network searches and ranking checks. Monitoring alerts are synchronized. Case-only changes are a no-op; duplicate values on the same website fail. Previous text and matching rules are overwritten.
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>",
"value": "<value>"
},
"name": "edit_keyword"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | The new word or phrase to look for, e.g. "acme crm". RedReplier trims and lowercases it. Another keyword on the same website with the same text makes the call fail | |
| keywordId | Yes | ID of the keyword to change, 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 |