Bookings
Reassign a booking to a specific user
Getting Started
Platform / Cal Provider
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Delegation Credentials
Orgs / Event Types
Orgs / Memberships
Orgs / Orgs
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Memberships
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Schedules
Orgs / Users / OOO
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Bookings
Reassign a booking to a specific user
POST
/
v2
/
bookings
/
{bookingUid}
/
reassign
/
{userId}
curl --request POST \
--url https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '{
"reason": "Host has to take another call"
}'
{
"status": "success",
"data": {}
}
Headers
Must be set to 2024-08-13
value must be Bearer <token>
where <token>
either managed user access token or api key prefixed with cal_
Body
application/json
Reason for reassigning the booking
Example:
"Host has to take another call"
Response
200 - application/json
Available options:
success
, error
Example:
"success"
Booking data, which can be either a ReassignAutoBookingOutput object or a ReassignManualBookingOutput object
Available options:
success
, error
Example:
"success"
Booking data, which can be either a ReassignAutoBookingOutput object or a ReassignManualBookingOutput object
Available options:
success
, error
Example:
"success"
Booking data, which can be either a ReassignAutoBookingOutput object or a ReassignManualBookingOutput object
Available options:
success
, error
Example:
"success"
Booking data, which can be either a ReassignAutoBookingOutput object or a ReassignManualBookingOutput object
curl --request POST \
--url https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'cal-api-version: <cal-api-version>' \
--data '{
"reason": "Host has to take another call"
}'
{
"status": "success",
"data": {}
}