Update a building permit alert
update_permit_alertUpdates a building permit alert by its palr_ id. Only the fields passed change, and each one overwrites the previous setting for every member of a shared alert. Same fields and the same place rules as create_permit_alert; active:true turns a paused alert back on. Does not use credits. Editing the filters here makes the alert API-made, so its scheduled runs are charged from then on: each new or changed permit a run adds counts as one export record, or 1 credit on API Only and the trial. Say so before changing filters. 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_permit_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | 1–120 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 | false pauses the alert. | |
| alertId | Yes | The permit alert's public id ("palr_…"), from list_permit_alerts or create_permit_alert. | |
| cadence | No | How often new matches are emailed: daily, weekly, or monthly. | |
| filters | No | The search_permits filter names as a JSON object, e.g. {"cities":["Lehi"],"workTypes":["pool"],"valueMin":50000}. Name a place (states, counties, or cities): at most 5 states and 25 counties or cities, unless the plan is nationwide, and inside the plan area. permitIds, contractorKeys, placeKey, and bbox cannot be saved on an alert. | |
| findContactInfo | No | true runs Find Contact Info on each run's new permits, up to 200 a run: 1 credit per permit only when it adds an email, phone, or personal LinkedIn profile the permit did not print. Homeowners are never looked up. Confirm with the user before turning it on. |