POST
/
v2
/
bookings
/
{bookingUid}
/
reschedule
Reschedule a booking
curl --request POST \
  --url https://api.cal.com/v2/bookings/{bookingUid}/reschedule \
  --header 'Content-Type: application/json' \
  --header 'cal-api-version: <cal-api-version>' \
  --data '{
  "start": "2024-08-13T10:00:00Z",
  "rescheduledBy": "<string>",
  "reschedulingReason": "User requested reschedule",
  "emailVerificationCode": "123456"
}'
{
  "status": "success",
  "data": {
    "id": 123,
    "uid": "booking_uid_123",
    "title": "Consultation",
    "description": "Learn how to integrate scheduling into marketplace.",
    "hosts": [
      {
        "id": 1,
        "name": "Jane Doe",
        "email": "[email protected]",
        "username": "jane100",
        "timeZone": "America/Los_Angeles"
      }
    ],
    "status": "accepted",
    "cancellationReason": "User requested cancellation",
    "cancelledByEmail": "[email protected]",
    "reschedulingReason": "User rescheduled the event",
    "rescheduledByEmail": "[email protected]",
    "rescheduledFromUid": "previous_uid_123",
    "rescheduledToUid": "new_uid_456",
    "start": "2024-08-13T15:30:00Z",
    "end": "2024-08-13T16:30:00Z",
    "duration": 60,
    "eventTypeId": 50,
    "eventType": {
      "id": 1,
      "slug": "some-event"
    },
    "meetingUrl": "https://example.com/recurring-meeting",
    "location": "https://example.com/meeting",
    "absentHost": true,
    "createdAt": "2024-08-13T15:30:00Z",
    "updatedAt": "2024-08-13T15:30:00Z",
    "metadata": {
      "key": "value"
    },
    "rating": 4,
    "icsUid": "ics_uid_123",
    "attendees": [
      {
        "name": "John Doe",
        "email": "[email protected]",
        "timeZone": "America/New_York",
        "language": "en",
        "absent": false,
        "phoneNumber": "+1234567890"
      }
    ],
    "guests": [
      "[email protected]",
      "[email protected]"
    ],
    "bookingFieldsResponses": {
      "customField": "customValue"
    }
  }
}

Headers

​
cal-api-version
string
default:2024-08-13
required

Must be set to 2024-08-13

​
Authorization
string

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

​
x-cal-secret-key
string

For platform customers - OAuth client secret key

​
x-cal-client-id
string

For platform customers - OAuth client ID

Path Parameters

​
bookingUid
string
required

Body

application/json

Accepts different types of reschedule booking input: Reschedule Booking (Option 1) or Reschedule Seated Booking (Option 2).

If you are rescheduling a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or
  you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner.
​
start
string
required

Start time in ISO 8601 format for the new booking

Example:

"2024-08-13T10:00:00Z"

​
rescheduledBy
string

Email of the person who is rescheduling the booking - only needed when rescheduling a booking that requires a confirmation. If event type owner email is provided then rescheduled booking will be automatically confirmed. If attendee email or no email is passed then the event type owner will have to confirm the rescheduled booking.

​
reschedulingReason
string

Reason for rescheduling the booking

Example:

"User requested reschedule"

​
emailVerificationCode
string

Email verification code required when event type has email verification enabled.

Example:

"123456"

Response

201 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object
required

Booking data, which can be either a BookingOutput object or a RecurringBookingOutput object