Change booking
Moves a booking using a native reschedule quote (changing_booking_id), or an ordinary provider availability quote, and returns the updated booking. Provider writes claim the mirrored version before I/O; a competing or uncertain write answers 409 operation_in_progress. Retry the same key and body; completed replays bypass the old expected_version. Pass expected_version to refuse a change on a booking that moved on (409 stale_version). A booking the venue’s policy no longer lets the guest change answers 409 not_changeable with details.reason; a slot whose capacity is gone 409 slot_unavailable. Requires bookings:write.
Authorizations
API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.
Path Parameters
Body
A slot_token for the booking’s location: a reschedule search with changing_booking_id for native bookings, or an ordinary availability quote for provider-managed bookings.
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 - 255Replaces the guest’s note for native bookings. OpenTable note changes return 422 capability_unsupported.
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.