Reassign a booking to a specific host

Currently only supports reassigning host for round robin bookings. The provided authorization header refers to the owner of the booking.

Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.

If accessed using an OAuth access token, the BOOKING_WRITE scope is required.

POST /v2/bookings/{bookingUid}/reassign/{userId}

Reassign a booking to a specific host

cURL

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"
}
'

import requests

url = "https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}"

payload = { "reason": "Host has to take another call" }
headers = {
    "cal-api-version": "<cal-api-version>",
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'cal-api-version': '<cal-api-version>',
    Authorization: '<authorization>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({reason: 'Host has to take another call'})
};

fetch('https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'reason' => 'Host has to take another call'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json",
    "cal-api-version: <cal-api-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}"

	payload := strings.NewReader("{\n  \"reason\": \"Host has to take another call\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("cal-api-version", "<cal-api-version>")
	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}")
  .header("cal-api-version", "<cal-api-version>")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"reason\": \"Host has to take another call\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["cal-api-version"] = '<cal-api-version>'
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"reason\": \"Host has to take another call\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "status": "success",
  "data": "<unknown>"
}

Headers

cal-api-version · string · default: 2026-02-25 · required

Must be set to 2026-02-25.

Authorization · string · required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

bookingUid · string · required

userId · number · required

Body

application/json

reason · string

Reason for reassigning the booking

Example:

"Host has to take another call"

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · any · required

Booking data, which can be either a ReassignAutoBookingOutput object or a ReassignManualBookingOutput object