Appointments

Reserve Slot

Hold a slot for ten minutes while a booker fills in the form.

NOT a booking: nothing is written to a calendar and nobody is notified. The hold lapses by itself at release_at; release it explicitly if you know the booker walked away. A slot already taken is a 409.

post/appointments/slots/reserve

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/appointments/slots/reserve
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

event_type_idinteger required
slot_startstring required

ISO-8601 start of the slot being held.

slot_endstring required

ISO-8601 end of the slot being held.

Response

Successful Response

dataSchedulingPayload required

An open envelope for a filter, a setting, an embed config or a slot grid.

Open because org settings gain branding fields as the booking page does and the embed config gains styling keys as the widget does. Closing it would drop a field the app had already started returning.

Changes

No recorded changes to this operation across all 2 revisions of this API.