Update an alert
update_alertUpdates an alert by public id. Only the fields passed are changed, and each one overwrites the previous setting for every member of a shared alert. Does not use credits. Same fields as create_alert, including the share block {mode, userIds, optOutUserIds}. Any member of a shared alert may edit it. enrichContacts true or false turns contact lookup on or off for future runs (1 credit per project where a contact is found, on a paid plan or trial). Optional notify.emailTo (up to 5 extra addresses) and notify.webhookUrl save destinations outside this account. This call stores them and does not send. filters.leadTypes (for example ["private","public"]) widens an alert past private leads. Confirm with the user first.
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": {
"alertId": "<alertId>"
},
"name": "update_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | 1–255 characters. | |
| share | No | Team sharing. Any member of a shared alert may read, edit, run and delete it. Sharing requires a paid plan. | |
| active | No | ||
| notify | No | ||
| alertId | Yes | The planned-project alert's public id ("alr_…"), from list_alerts or create_alert. Permit alert ids ("palr_…") go to the permit alert tools. | |
| cadence | No | Defaults to weekly. | |
| filters | No | The same filter vocabulary as get_projects, as a JSON object — integer geo ids from list_locations, project-type values from get_project_types. At least one filter is required. An alert delivers private leads by default; put leadTypes (e.g. ["private","public"]) inside filters to widen it, exactly as on get_projects. | |
| enrichContacts | No | Find Contact Info on every run: each run looks up developer emails and phones on the records it delivered BEFORE notifying, then get_alert_matches with include "contacts" returns them, best contacts first. 1 credit per project the first time a contact is found, nothing otherwise. Needs a paid plan or live trial. Confirm with the user before turning it on. | |
| maxRecordsPerRun | No | Cap on records (= credits) one run may deliver. |