Seat booking
Acts on behalf of the venue at a granted location. Requires bookings:manage. Returns the full booking; stale versions answer 409 stale_version, illegal transitions 409 illegal_transition with details.from_status, and unsupported providers 422 capability_unsupported.
Authorizations
API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.
Path Parameters
Body
Optimistic concurrency: the version you last read. A booking that moved on since answers 409 stale_version with details.expected/actual.
Response
Success
booking Opaque, prefixed bkg_….
requested, confirmed, seated, completed, declined_by_venue, cancelled_by_guest, cancelled_by_venue, cancelled_unattributed, no_show expected, arrived, partially_seated, fully_seated, left ISO-8601 UTC instant.
Venue wall-clock, YYYY-MM-DDTHH:MM.
The venue service day the booking belongs to, YYYY-MM-DD.
Turn duration; null on provider-managed bookings, where Maple never invents one.
The guest-facing note; venue-internal notes are never exposed.
The channel the booking originated on, e.g. api_partner, voice_ai, internal.
maple, opentable, resy, sevenrooms ISO-8601 UTC instant.