hours replaces the whole week when present, because a rota is described as a week and a partial update of one window has no meaning anybody would expect. The calendar cannot be changed: it is the target’s identity for the booking ledger, so moving it would orphan every appointment made on the old one.
Calls
PUT /v1/integrations/calendar/{connectionId}/targets/{targetId}Arguments
string
required
Calendar connection ID.
string
required
Bookable target ID.
Options
string
Unique within the connection, and how a config file refers to this target. Letters, digits, spaces, _ or -.
integer
integer
Dead time before an appointment, counted as busy when a slot is offered. Defaults to 0.
integer
integer
How soon from now an appointment may be made. Defaults to 120.
integer
How far ahead appointments may be made. Defaults to 30.
integer
The grid slots are offered on. Defaults to the duration, which gives back-to-back appointments.
switch
Whether an all-day event closes the day. Defaults to true, because a calendar marks all-day events free unless their creator says otherwise and a public holiday entered as one would otherwise be bookable.
array
The windows of the week appointments are offered in. Omit to adopt Monday to Friday, 09:00 to 17:00. A target with no windows offers nothing at all, which reads to a caller as a permanently full diary.