Getting Started
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
- GETGet all attribute options
- POSTCreate an attribute option
- DELDelete an attribute option
- PATCHUpdate an attribute option
- GETGet by attribute id all of the attribute options that are assigned to users
- GETGet by attribute slug all of the attribute options that are assigned to users
- GETGet all attribute options for a user
- POSTAssign an attribute to a user
- DELUnassign an attribute from a user
Orgs / Bookings
Orgs / Delegation Credentials
Orgs / Memberships
Orgs / Routing forms
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Conferencing
- POSTConnect your conferencing application to a team
- GETGet OAuth conferencing app's auth url for a team
- GETList team conferencing applications
- POSTSet team default conferencing application
- GETGet team default conferencing application
- DELDisconnect team conferencing application
- GETSave conferencing app OAuth credentials
Orgs / Teams / Event Types
Orgs / Teams / Memberships
Orgs / Teams / Routing forms
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Users / Schedules
Orgs / Users / Bookings
Orgs / Users / OOO
Orgs / Users / Schedules
Orgs / Webhooks
Api Keys
Bookings
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
Managed Orgs
OAuth Clients
Organization Team Verified Resources
- POSTRequest Email Verification Code
- POSTRequest Phone Number Verification Code
- POSTVerify an email for an org team.
- POSTVerify a phone number for an org team.
- GETGet list of verified emails of an org team.
- GETGet list of verified phone numbers of an org team.
- GETGet verified email of an org team by id.
- GETGet verified phone number of an org team by id.
Organizations/Teams Stripe
Routing forms
Schedules
Selected Calendars
Slots
Teams / Event Types
Teams / Memberships
Teams Verified Resources
- POSTRequest Email Verification Code
- POSTRequest Phone Number Verification Code
- POSTVerify an email for a team.
- POSTVerify a phone number for an org team.
- GETGet list of verified emails of a team.
- GETGet list of verified phone numbers of a team.
- GETGet verified email of a team by id.
- GETGet verified phone number of a team by id.
Verified Resources
Updated reserved a slot
curl --request PATCH \
--url https://api.cal.com/v2/slots/reservations/{uid} \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '{
"eventTypeId": 1,
"slotStart": "2024-09-04T09:00:00Z",
"slotDuration": "30",
"reservationDuration": 5
}'
{
"status": "success",
"data": {
"eventTypeId": 1,
"slotStart": "2024-09-04T09:00:00Z",
"slotEnd": "2024-09-04T10:00:00Z",
"slotDuration": "30",
"reservationUid": "e84be5a3-4696-49e3-acc7-b2f3999c3b94",
"reservationDuration": 5,
"reservationUntil": "2023-09-04T10:00:00Z"
}
}
Headers
Must be set to 2024-09-04
Path Parameters
Body
The ID of the event type for which slot should be reserved.
1
ISO 8601 datestring in UTC timezone representing available slot.
"2024-09-04T09:00:00Z"
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.
"30"
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.
5
Response
success
, error
"success"
The ID of the event type for which slot was reserved.
1
ISO 8601 datestring in UTC timezone representing available slot.
"2024-09-04T09:00:00Z"
ISO 8601 datestring in UTC timezone representing slot end.
"2024-09-04T10:00:00Z"
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. If you don't have this set explicitly that event type can have one of many lengths you can omit this.
"30"
The unique identifier of the reservation. Use it to update, get or delete the reservation.
"e84be5a3-4696-49e3-acc7-b2f3999c3b94"
For how many minutes the slot is reserved - for this long time noone else can book this event type at start
time.
5
ISO 8601 datestring in UTC timezone representing time until which the slot is reserved.
"2023-09-04T10:00:00Z"
Was this page helpful?
curl --request PATCH \
--url https://api.cal.com/v2/slots/reservations/{uid} \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '{
"eventTypeId": 1,
"slotStart": "2024-09-04T09:00:00Z",
"slotDuration": "30",
"reservationDuration": 5
}'
{
"status": "success",
"data": {
"eventTypeId": 1,
"slotStart": "2024-09-04T09:00:00Z",
"slotEnd": "2024-09-04T10:00:00Z",
"slotDuration": "30",
"reservationUid": "e84be5a3-4696-49e3-acc7-b2f3999c3b94",
"reservationDuration": 5,
"reservationUntil": "2023-09-04T10:00:00Z"
}
}