Tools

Actions

get_actions

Returns the Action Center alerts and recommendations for your listings: missing listing information, configuration issues, availability alerts, and pricing recommendations. Grouped per listing, most important first.

Best for: “What needs my attention?”, “What should I fix on this listing?”, triaging a portfolio before a pricing review, and finding listings that are missing setup.

Example: “What needs my attention across my listings?” or “What should I fix on Sunset Villa?”

Parameters

ParameterTypeRequiredDescription
questionstringYesVerbatim user text for this request (exactly as typed).
listing_idstringNoRestrict to one listing. Must be provided together with pms.
pmsstringNoPMS name of the listing. Must be provided together with listing_id. Omit both to return actions for every accessible listing.
modestringNovisible (default) returns only actions that are not hidden, all ignores your visibility preferences, hidden returns only hidden actions.

Action types

Categoryaction_typeMeaning
Pricing recommendationsbase_price_alertA new base price is recommended.
min_price_alertA lower minimum price is recommended.
Missing listing informationbase_price_missingThe listing has no base price set.
location_missingThe listing has no location, so neighborhood data cannot be used.
bedroom_count_missingThe listing has no bedroom count, so market comparisons are less accurate.
Configuration issuesoba_turned_offOccupancy Based Adjustments are turned off.
last_minute_conservative_vs_marketLast minute discounts do not match market trends.
minimum_stay_off_vs_marketMinimum stay settings do not match the market.
Availability alertsmany_unbookable_datesStay restrictions are preventing bookings on available nights.
many_blocked_datesA large number of dates are blocked.

Response format

One entry per listing that has at least one active action. Listings with nothing to report are omitted, so the list can be empty.

FieldDescription
listing_detailslisting_id, pms, pms_display_name, and listing_name.
actionsThe listing’s actions, most important first. Each has action_type, a human-readable title, and metadata.

metadata is empty for actions that only flag a missing or disabled setting. Otherwise it carries the detail for that action:

  • Price recommendations — nudge_id, current, recommended, direction, expiration
  • Minimum stay and last minute — current and recommended values
  • Blocked and unbookable dates — count, threshold, and date_ranges

Price recommendations include a nudge_id. Pass it to the accept_nudge tool together with the listing’s listing_id and pms to apply the recommended price.