Update Booking

Update an existing booking. Supports updating the title, time, duration,
description, location, and attendees of the meeting. The underlying calendar
event is updated and participants are notified by default.

Cannot be used on cancelled bookings or to set a start time in the past.

When you change the time, the new slot is validated against the meeting
template it was booked from. The request returns 400, with the reason in the
response message, if the new slot:

  • falls outside the template's open hours
  • falls inside the template's minimum notice period
  • falls beyond the template's booking window
  • overlaps another meeting on the assigned interviewer's calendar,
    including the template's buffer either side

Moving a booking within its own existing slot is always allowed. Changes
that do not alter the time are not validated against the template.

The request also returns 400 if the template's rules cannot be read at all —
for example if its scheduler configuration is missing open hours, a notice
period or a booking window, or if the booking's organizer calendar cannot be
resolved. These are reported separately from a rule that was evaluated and
failed, so you can tell "your time is outside the open hours" from "we could
not read this template".

Returns 404 if the booking does not exist, or if it belongs to a different
organisation than the one tied to the API key.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The unique identifier of the booking

Body Params

The fields to update on the booking

string

New meeting title.

date-time

New start time in ISO 8601 format. Must be in the future. Must be supplied with duration.

integer
1 to 1440

New duration in minutes. Must be supplied with startDateTime.

string

New meeting description / agenda.

string

New meeting location — physical address or video link.

attendees
array of objects
length ≥ 1

Full attendee list. Adding new attendees sends invites; removing attendees sends cancellations.

Attendees
boolean
Defaults to true

Whether to notify participants of the update. Defaults to true.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json