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

idrequiredstringMonitor 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.