Skip to main content
POST
Edit booking resource, service, and dates

Autorisierungen

Authorization
string
header
erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Header

Authorization
string
erforderlich

Bearer Token

Pfadparameter

booking_id
string
erforderlich

Booking identifier

Abfrageparameter

o
string
erforderlich

Organization ID

include
string

Comma-separated related resources to sideload, for example resource.parent.

Body

application/json
start_date
string<date-time>
erforderlich

New start (Atom). Required — omitting it is 422, not 'keep current'.

end_date
string<date-time>

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.

resource_id

Target resource. Omit to keep the current resource.

service_id
object

Map of service_id → quantity. Omit to keep the current service configuration.

booking_quota_grant_id

Quota grant in the active organization to charge the edited booking against.

duration
integer

Manual duration in the service unit (usually minutes). Sets end_date to start_date + duration and skips interval snapping.

Erforderlicher Bereich: x >= 1
override_duration
boolean

Keep the requested end_date instead of snapping it to a validated service interval. Implied when duration is set.

padding_before
integer

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.

Erforderlicher Bereich: x >= 0
padding_after
integer

Override the service follow-up padding for this edit (blocker after end). 0 clears it. Omit to use the (new) service default.

Erforderlicher Bereich: x >= 0

Antwort

Updated booking

data
Booking · object

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 expiration
  • requested — needs manual acceptance by admin
  • accepted — accepted (automatically or manually)
  • rejected — rejected by admin before fulfillment; always yields a 100% refund when payment exists
  • canceled — canceled by customer or admin; refund follows the configured cancellation policy conditions
  • expired — booking expired because the check-in time passed without check-in