Skip to main content
POST
Decline a booking

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

Body

application/json
reason
string

Reason for declining a booking that requires a confirmation

Example:

"Host has to take another call"

Response

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

"success"

data
object
required

Booking data, which can be either a BookingOutput object, a RecurringBookingOutput object, or an array of RecurringBookingOutput objects