patch · monitors:write
Replace a monitor keyword list
Replace a monitor keyword list
WriteIdempotent
REST
patch
/api/v1/keywords/{id}curl "https://herculeradar.com/api/v1/keywords/:id" \
--request PATCH \
--header "Authorization: Bearer hr_live_…" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{"keywords":["Acme","acme.dev"]}'MCP
Tool name update_keyword. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.
Rename is not supported; change the monitor keyword list via update_monitor.
Parameters
| idrequired | string | Monitor id |
Request body
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Response
{
"data": {
"id": "uuid",
"keywords": [
"Acme",
"acme.dev"
]
},
"meta": {
"capability": "update_keyword",
"requestId": "req_9f2b4a8c1d0e",
"idempotencyReplayed": false,
"docs": "https://herculeradar.com/docs/reference/update_keyword"
}
}Authorization
Requires the monitors:write scope. A credential without it gets 403 FORBIDDEN. Resources in projects the credential cannot reach answer 404 NOT_FOUND rather than 403, so ids cannot be probed across tenants.
Send an Idempotency-Key header. A completed response is replayed for 24 hours, so a retry after a timeout cannot create a duplicate.