Update a bookable target
Changes what agents ALREADY PUBLISHED against this target book, with no new tool version, the same thing editing a Cal.com event type on cal.com does. 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.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Calendar connection ID
Bookable target ID
Body
Fields to change. At least one is required. hours replaces the whole week, because a rota is described as a week.
Unique within the connection, and how a config file refers to this target. Letters, digits, spaces, _ or -.
1 - 120"Front desk"
x <= 144030
Dead time before an appointment, counted as busy when a slot is offered. Defaults to 0.
0 <= x <= 14400 <= x <= 1440How soon from now an appointment may be made. Defaults to 120.
0 <= x <= 525600How far ahead appointments may be made. Defaults to 30.
x <= 365The grid slots are offered on. Defaults to the duration, which gives back-to-back appointments.
x <= 1440Whether 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.
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.
1 - 42 elementsResponse
The updated target.
Something on a connected account an agent can be pointed at: a Cal.com event type, or a bookable target on a calendar whose booking policy Roark owns.