Cancel booking as the venue
Cancels a booking on the venue’s behalf, for host-stand and POS apps, and returns it as cancelled_by_venue; its capacity is offered again. The guest’s cancellation window does not apply. Pass expected_version to refuse a cancel on a booking that moved on (409 stale_version); a booking that is seated or finished answers 409 not_cancellable. Retry-safe under idempotency_key. Maple-native bookings only (422 capability_unsupported otherwise). Requires bookings:manage.
Authorizations
API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.
Path Parameters
Body
Your unique key for this write (body-level, scoped to your app). Retrying with the same key and the same request replays the same booking; the same key with a different request answers 409 idempotency_key_reused.
1 - 255Optimistic 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 The experience booked (prix fixe, ticketed seating), or null for a standard reservation.
ISO-8601 UTC instant.