Skip to content

Reservations — FOH actions

Pause or resume taking NEW online / AI bookings for TODAY only (resets tomorrow). Use when an owner says ‘we’re slammed, stop taking bookings’ or ‘we’re short-staffed today’. FOH can still add reservations manually while paused; future days are unaffected. Set paused:false to resume.

Required scope: bookings.write

Parameter Type Required Description
brand string no Brand slug. Optional in JWT mode.
paused boolean yes true = stop new bookings for today; false = resume.
idempotencyKey string no

Text a waiting guest that their table is ready. Use when a party is waiting/at-the-door and their table has been assigned. Requires the reservation to have an assigned table and a phone on file (both surfaced as clear errors otherwise). `id` is the reservation id (from list_bookings).

Required scope: bookings.write

Parameter Type Required Description
brand string no Brand slug. Optional in JWT mode.
id string yes Reservation id (from list_bookings).
idempotencyKey string no

Assign one or more tables to a reservation — by table NAME (e.g. “12” or “Patio 3”) or id. Use when an owner/host says ‘put the Smith party on table 12’. Optionally seat them in the same step (seat:true) or text them their table is ready (notify:true). `id` is the reservation id (from list_bookings).

Required scope: bookings.write

Parameter Type Required Description
brand string no Brand slug. Optional in JWT mode.
id string yes Reservation id (from list_bookings).
tables array yes Table name(s) or id(s), e.g. [“12”] or [“Patio 3”,“Patio 4”] for a combo.
seat boolean no Also mark the party seated now (flips status → seated).
notify boolean no Text the guest their table is ready (ignored when seat:true).
idempotencyKey string no