Edit an alert
update_alertChange an existing alert instead of replacing it. Dates, nights, notifications, party size, activity and equipment can all be edited, and the campground_selections can be NARROWED.
Prefer this over delete-and-recreate: an alert carries its scan history and accumulated odds, a recreate throws both away and leaves the user unwatched in between. Prefer it over a second alert too — every alert costs a slot against the tier limit and the 100-alert cap.
SELECTIONS ONLY NARROW. You may remove sites, zones or campgrounds; you may not add any, and you may not change the park. Quota is priced on what an alert watches, so an edit that grew a selection would route around the check that priced it. To watch MORE, create a second alert, or delete this one and create it again with the full list — and say which you did.
Omit a field to leave it alone; pass null to clear one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alert_id | Yes | The alert's id, from list_my_alerts or create_alert. | |
| date_end | No | YYYY-MM-DD — the last bookable NIGHT. | |
| pets_only | No | Only sites that allow pets. | |
| tent_pads | No | Backcountry ZONE inventory only (Parks Canada): how many tent pads the party needs. Ignored elsewhere. | |
| date_start | No | YYYY-MM-DD. | |
| nights_max | No | Longest stay to accept, in nights; omit to accept any length from nights_min up. | |
| nights_min | No | Shortest stay to accept, in nights. | |
| notify_sms | No | Text message on a match. Pro tier only and silently dropped otherwise, needs a verified phone number, and it is the one channel that costs real money per send — it stays off unless the user has asked for texts. | |
| party_size | No | People in the party. Where inventory is per bed or per person (huts, some backcountry zones) an opening must fit this many. | |
| split_stay | No | Accept a stay split across DIFFERENT sites rather than one site for every night. More matches, at the cost of moving camp mid-trip. | |
| days_filter | No | Which arrival days count: every day, weekends only, or weekdays only. | |
| entry_dates | No | ENTRY-DATE inventory only: the exact dates wanted, YYYY-MM-DD. Replaces the current set, so pass every date you still want. | |
| notify_push | No | Send a push notification to the account holder's phone when something opens. | |
| is_tent_only | No | Only tent-only sites, for campers who want to avoid being pitched beside RVs. NOT the same as equipment_filter_mode 'tent'. | |
| notify_email | No | Paid tiers only; silently dropped otherwise. | |
| activity_type | No | The activity the alert watches (as listed on the park: camping, backcountry, day_use, …). | |
| is_accessible | No | Only wheelchair-accessible sites. | |
| has_electricity | No | Only sites with an electrical hookup. | |
| is_pull_through | No | Only pull-through sites (no reversing) — for big rigs. | |
| sub_equipment_id | No | From list_equipment_options for this park's provider. Never guess it: the integers are per-provider and a wrong one filters to the wrong sites silently. | |
| campground_selections | No | The NARROWED selection — a strict subset of what the alert already watches. Anything not listed stops being watched. | |
| equipment_filter_mode | No | What the user is camping IN. 'any' watches every site regardless. Pair 'tent' or 'rv' with sub_equipment_id from list_equipment_options — the mode alone does not say WHICH trailer. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| park_id | No | ||
| user_id | No | ||
| date_end | No | ||
| provider | No | ||
| is_active | No | ||
| park_name | No | ||
| pets_only | No | ||
| tent_pads | No | ||
| alert_type | No | ||
| created_at | No | ||
| date_start | No | ||
| nights_max | No | ||
| nights_min | No | ||
| notify_sms | No | ||
| party_size | No | ||
| scan_count | No | ||
| shade_only | No | ||
| split_stay | No | ||
| updated_at | No | ||
| booking_url | No | ||
| created_via | No | ||
| days_filter | No | ||
| entry_dates | No | ||
| notify_push | No | ||
| is_tent_only | No | ||
| notify_email | No | ||
| activity_type | No | ||
| day_use_cells | No | ||
| is_accessible | No | ||
| out_of_season | No | ||
| has_electricity | No | ||
| is_pull_through | No | ||
| last_checked_at | No | ||
| waterfront_only | No | ||
| created_by_agent | No | ||
| last_notified_at | No | ||
| sub_equipment_id | No | ||
| notification_count | No | ||
| cancellations_found | No | ||
| availabilities_found | No | ||
| campground_selections | No | ||
| equipment_filter_mode | No | ||
| op_access_point_resource_id | No |