Cancel booking
Cancels a booking on the guest’s behalf, synchronously, and returns it as cancelled_by_guest; its capacity is offered again. Pass expected_version to refuse a cancel on a booking that moved on (409 stale_version). A booking the venue’s policy no longer lets the guest cancel answers 409 not_cancellable with details.reason. Requires bookings:write.
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 ISO-8601 UTC instant.