PATCH
/
v2
/
slots
/
reservations
/
{uid}

Headers

cal-api-version
string
required

Must be set to 2024-09-04

Path Parameters

uid
string
required

Body

application/json
eventTypeId
number
required

The ID of the event type for which slot should be reserved.

slotStart
string
required

ISO 8601 datestring in UTC timezone representing available slot.

slotDuration
number

By default slot duration is equal to event type length, but if you want to reserve a slot for an event type that has a variable length you can specify it here as a number in minutes. If you don't have this set explicitly that event type can have one of many lengths you can omit this.

reservationDuration
number

ONLY for authenticated requests with api key, access token or OAuth credentials (ID + secret).

  For how many minutes the slot should be reserved - for this long time noone else can book this event type at `start` time. If not provided, defaults to 5 minutes.

Response

200 - application/json
status
enum<string>
required
Available options:
success,
error
data
object
required