Edit booking resource, service, and dates
Admin-only edit of a confirmed booking’s resource, service configuration, dates, optional quota grant, and optional padding. Applies immediately — there is no preview or cancel-edit step. Customer edit gates (canEditPeriod, reschedule deadline) are ignored. Availability is not enforced.
start_date is required (Atom). end_date is required unless duration is set. Without override_duration / duration, the end is snapped to a validated interval of the (new) service — so changing service_id updates the booking duration when the old window is not valid for the new service. charged_duration follows the new service’s pricing rules (fixed = one interval; flexible = ceil of the window).
padding_before / padding_after override the service defaults for this edit only (blocker window). Omit them to adopt the new service’s padding.
Without service_id, a booking on a child resource may only move to a sibling of the same parent. With service_id, the booking may move to any organization resource, including one not wired to the service. A multi-service service_id map on a sequence-capable resource turns the booking into a sequence parent; dropping back to one service collapses it.
Price corrections are parked as an unlocked draft invoice on the order. See the Admin Booking Edit guide.
Autorisierungen
The access token received from the authorization server in the OAuth 2.0 flow.
Header
Bearer Token
Pfadparameter
Booking identifier
Abfrageparameter
Organization ID
Comma-separated related resources to sideload, for example resource.parent.
Body
New start (Atom). Required — omitting it is 422, not 'keep current'.
New end (Atom), after_or_equal start_date. Required unless duration is set. Unless override_duration or duration is set, snapped to the last validated end interval of the (new) service that still fits the request.
Target resource. Omit to keep the current resource.
Map of service_id → quantity. Omit to keep the current service configuration.
Quota grant in the active organization to charge the edited booking against.
Manual duration in the service unit (usually minutes). Sets end_date to start_date + duration and skips interval snapping.
x >= 1Keep the requested end_date instead of snapping it to a validated service interval. Implied when duration is set.
Override the service preparation padding for this edit (blocker before start). 0 clears it. Omit to use the (new) service default. Does not write the Service row.
x >= 0Override the service follow-up padding for this edit (blocker after end). 0 clears it. Omit to use the (new) service default.
x >= 0Antwort
Updated booking
A booking blocks the related resource from start_date until its end_date while its status is reserved, requested or accepted.
Status values:
reserved— booking is reserved until order expirationrequested— needs manual acceptance by adminaccepted— accepted (automatically or manually)rejected— rejected by admin before fulfillment; always yields a 100% refund when payment existscanceled— canceled by customer or admin; refund follows the configured cancellation policy conditionsexpired— booking expired because the check-in time passed without check-in