update_keyword
writeKeyword Research & Management
Update a target keyword's tier, cluster assignment, or target URL.
Connected surface
This tool and the Keywords dashboard page are two surfaces over the same data. The dashboard is where you view and curate it;
update_keyword is how your AI can retier and retarget keywords as the strategy conversation evolves. How surfaces connect →Write tool
Mutates Rampify state, triggers background work, or calls a paid external API. Most clients ask for confirmation before invoking.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| domain | string | optional | Site domain (optional override) |
| project_id | string | optional | Project UUID (optional override) |
| keyword_id | string | optional | Single keyword UUID (alternative to keyword_ids) |
| keyword_ids | string[] | optional | Multiple keyword UUIDs for batch update |
| tier | enum("primary" | "secondary" | "tertiary") | optional | New tier |
| cluster_id | string | null | optional | Target cluster ID; pass null to move to unclustered |
| target_url | string | optional | Target URL path |