Skip to main content
Manages a recurring meal or grocery subscription at a linked merchant (for example Locale): browse the recurring menu, skip or resume delivery dates, and update plan settings. It is not a one-time purchase and takes no payment, since the subscription auto-bills the card on file at the merchant.

Parameters

ParameterTypeRequiredDescription
merchantstringYesMerchant slug (for example locale)
actionstringYesOne of menu_search, get_skip_dates, skip, unskip, set_skip_dates, or update_setting
querystringNoFor menu_search: search term over the recurring menu; an empty string lists everything
limitnumberNoFor menu_search: max items to return
datestringNoFor skip and unskip: one ISO delivery date (YYYY-MM-DD)
datesarray of stringsNoFor set_skip_dates: the full set of ISO dates to skip; an empty array resumes all
settingstringNoFor update_setting: the setting key, such as subscription_size, diets, or default_window
valueanyNoFor update_setting: the new value (number, string, or array of strings)

Returns

Depends on the action: menu_search lists matching dishes and flags the ones covered by the plan, get_skip_dates lists skipped or paused deliveries, and skip, unskip, and set_skip_dates confirm the updated skip list. update_setting confirms the changed setting. Failures return a short “Could not manage” message, and skip, unskip, and update_setting remind you if a required field is missing.

Example

{ "name": "manage_subscription", "arguments": { "merchant": "locale", "action": "skip", "date": "2026-07-10" } }