Cal.com · Capability
Cal.diy API v2 — Bookings
Cal.diy API v2 — Bookings. 17 operations. Lead operation: Create a booking. Self-contained Naftiko capability covering one Cal Com business surface.
What You Can Do
POST
Bookingscontroller20240813createbooking
— Create a booking
/v1/v2/bookings
GET
Bookingscontroller20240813getbookings
— Get all bookings
/v1/v2/bookings
GET
Bookingscontroller20240813getbookingbyseatuid
— Get a booking by seat UID
/v1/v2/bookings/by-seat/{seatuid}
GET
Bookingscontroller20240813getbooking
— Get a booking
/v1/v2/bookings/{bookinguid}
GET
Bookingscontroller20240813getcalendarlinks
— Get 'Add to Calendar' links for a booking
/v1/v2/bookings/{bookinguid}/calendar-links
POST
Bookingscontroller20240813cancelbooking
— Cancel a booking
/v1/v2/bookings/{bookinguid}/cancel
GET
Bookingscontroller20240813getvideosessions
— Get Video Meeting Sessions. Only supported for Cal Video
/v1/v2/bookings/{bookinguid}/conferencing-sessions
POST
Bookingscontroller20240813confirmbooking
— Confirm a booking
/v1/v2/bookings/{bookinguid}/confirm
POST
Bookingscontroller20240813declinebooking
— Decline a booking
/v1/v2/bookings/{bookinguid}/decline
PATCH
Bookinglocationcontroller20240813updatebookinglocation
— Update booking location for an existing booking
/v1/v2/bookings/{bookinguid}/location
POST
Bookingscontroller20240813marknoshow
— Mark a booking absence
/v1/v2/bookings/{bookinguid}/mark-absent
POST
Bookingscontroller20240813reassignbooking
— Reassign a booking to auto-selected host
/v1/v2/bookings/{bookinguid}/reassign
POST
Bookingscontroller20240813reassignbookingtouser
— Reassign a booking to a specific host
/v1/v2/bookings/{bookinguid}/reassign/{userid}
GET
Bookingscontroller20240813getbookingrecordings
— Get all the recordings for the booking
/v1/v2/bookings/{bookinguid}/recordings
GET
Bookingscontroller20240813getbookingreferences
— Get booking references
/v1/v2/bookings/{bookinguid}/references
POST
Bookingscontroller20240813reschedulebooking
— Reschedule a booking
/v1/v2/bookings/{bookinguid}/reschedule
GET
Bookingscontroller20240813getbookingtranscripts
— Get Cal Video real time transcript download links for the booking
/v1/v2/bookings/{bookinguid}/transcripts
MCP Tools
create-booking
Create a booking
get-all-bookings
Get all bookings
read-only
idempotent
get-booking-seat-uid
Get a booking by seat UID
read-only
idempotent
get-booking
Get a booking
read-only
idempotent
get-add-calendar-links-booking
Get 'Add to Calendar' links for a booking
read-only
idempotent
cancel-booking
Cancel a booking
get-video-meeting-sessions-only
Get Video Meeting Sessions. Only supported for Cal Video
read-only
idempotent
confirm-booking
Confirm a booking
decline-booking
Decline a booking
update-booking-location-existing-booking
Update booking location for an existing booking
idempotent
mark-booking-absence
Mark a booking absence
reassign-booking-auto-selected-host
Reassign a booking to auto-selected host
reassign-booking-specific-host
Reassign a booking to a specific host
get-all-recordings-booking
Get all the recordings for the booking
read-only
idempotent
get-booking-references
Get booking references
read-only
idempotent
reschedule-booking
Reschedule a booking
get-cal-video-real-time
Get Cal Video real time transcript download links for the booking
read-only
idempotent
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Cal.diy API v2 — Bookings
description: 'Cal.diy API v2 — Bookings. 17 operations. Lead operation: Create a booking. Self-contained Naftiko capability
covering one Cal Com business surface.'
tags:
- Cal Com
- Bookings
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
CAL_COM_API_KEY: CAL_COM_API_KEY
capability:
consumes:
- type: http
namespace: cal-com-bookings
baseUri: ''
description: Cal.diy API v2 — Bookings business capability. Self-contained, no shared references.
resources:
- name: v2-bookings
path: /v2/bookings
operations:
- name: bookingscontroller20240813createbooking
method: POST
description: Create a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
- name: x-cal-secret-key
in: header
type: string
description: For platform customers - OAuth client secret key
- name: x-cal-client-id
in: header
type: string
description: For platform customers - OAuth client ID
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: bookingscontroller20240813getbookings
method: GET
description: Get all bookings
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: status
in: query
type: array
description: Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.
- name: attendeeEmail
in: query
type: string
description: Filter bookings by the attendee's email address.
- name: attendeeName
in: query
type: string
description: Filter bookings by the attendee's name.
- name: bookingUid
in: query
type: string
description: Filter bookings by the booking Uid.
- name: eventTypeIds
in: query
type: string
description: Filter bookings by event type ids belonging to the user. Event type ids must be separated by a comma.
- name: eventTypeId
in: query
type: string
description: Filter bookings by event type id belonging to the user.
- name: teamsIds
in: query
type: string
description: Filter bookings by team ids that user is part of. Team ids must be separated by a comma.
- name: teamId
in: query
type: string
description: Filter bookings by team id that user is part of
- name: afterStart
in: query
type: string
description: Filter bookings with start after this date string.
- name: beforeEnd
in: query
type: string
description: Filter bookings with end before this date string.
- name: afterCreatedAt
in: query
type: string
description: Filter bookings that have been created after this date string.
- name: beforeCreatedAt
in: query
type: string
description: Filter bookings that have been created before this date string.
- name: afterUpdatedAt
in: query
type: string
description: Filter bookings that have been updated after this date string.
- name: beforeUpdatedAt
in: query
type: string
description: Filter bookings that have been updated before this date string.
- name: sortStart
in: query
type: string
description: Sort results by their start time in ascending or descending order.
- name: sortEnd
in: query
type: string
description: Sort results by their end time in ascending or descending order.
- name: sortCreated
in: query
type: string
description: Sort results by their creation time (when booking was made) in ascending or descending order.
- name: sortUpdatedAt
in: query
type: string
description: Sort results by their updated time (for example when booking status changes) in ascending or descending
order.
- name: take
in: query
type: number
description: The number of items to return
- name: skip
in: query
type: number
description: The number of items to skip
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-by-seat-seatUid
path: /v2/bookings/by-seat/{seatUid}
operations:
- name: bookingscontroller20240813getbookingbyseatuid
method: GET
description: Get a booking by seat UID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: seatUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
- name: x-cal-secret-key
in: header
type: string
description: For platform customers - OAuth client secret key
- name: x-cal-client-id
in: header
type: string
description: For platform customers - OAuth client ID
- name: v2-bookings-bookingUid
path: /v2/bookings/{bookingUid}
operations:
- name: bookingscontroller20240813getbooking
method: GET
description: Get a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
- name: x-cal-secret-key
in: header
type: string
description: For platform customers - OAuth client secret key
- name: x-cal-client-id
in: header
type: string
description: For platform customers - OAuth client ID
- name: v2-bookings-bookingUid-calendar-links
path: /v2/bookings/{bookingUid}/calendar-links
operations:
- name: bookingscontroller20240813getcalendarlinks
method: GET
description: Get 'Add to Calendar' links for a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-cancel
path: /v2/bookings/{bookingUid}/cancel
operations:
- name: bookingscontroller20240813cancelbooking
method: POST
description: Cancel a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
- name: x-cal-secret-key
in: header
type: string
description: For platform customers - OAuth client secret key
- name: x-cal-client-id
in: header
type: string
description: For platform customers - OAuth client ID
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-conferencing-sessions
path: /v2/bookings/{bookingUid}/conferencing-sessions
operations:
- name: bookingscontroller20240813getvideosessions
method: GET
description: Get Video Meeting Sessions. Only supported for Cal Video
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-confirm
path: /v2/bookings/{bookingUid}/confirm
operations:
- name: bookingscontroller20240813confirmbooking
method: POST
description: Confirm a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-decline
path: /v2/bookings/{bookingUid}/decline
operations:
- name: bookingscontroller20240813declinebooking
method: POST
description: Decline a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-location
path: /v2/bookings/{bookingUid}/location
operations:
- name: bookinglocationcontroller20240813updatebookinglocation
method: PATCH
description: Update booking location for an existing booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. This header is required as this endpoint does not exist in older API versions.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-mark-absent
path: /v2/bookings/{bookingUid}/mark-absent
operations:
- name: bookingscontroller20240813marknoshow
method: POST
description: Mark a booking absence
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-reassign
path: /v2/bookings/{bookingUid}/reassign
operations:
- name: bookingscontroller20240813reassignbooking
method: POST
description: Reassign a booking to auto-selected host
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-reassign-userId
path: /v2/bookings/{bookingUid}/reassign/{userId}
operations:
- name: bookingscontroller20240813reassignbookingtouser
method: POST
description: Reassign a booking to a specific host
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: userId
in: path
type: number
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-recordings
path: /v2/bookings/{bookingUid}/recordings
operations:
- name: bookingscontroller20240813getbookingrecordings
method: GET
description: Get all the recordings for the booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-references
path: /v2/bookings/{bookingUid}/references
operations:
- name: bookingscontroller20240813getbookingreferences
method: GET
description: Get booking references
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: type
in: query
type: string
description: Filter booking references by type
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
- name: v2-bookings-bookingUid-reschedule
path: /v2/bookings/{bookingUid}/reschedule
operations:
- name: bookingscontroller20240813reschedulebooking
method: POST
description: Reschedule a booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
- name: x-cal-secret-key
in: header
type: string
description: For platform customers - OAuth client secret key
- name: x-cal-client-id
in: header
type: string
description: For platform customers - OAuth client ID
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: v2-bookings-bookingUid-transcripts
path: /v2/bookings/{bookingUid}/transcripts
operations:
- name: bookingscontroller20240813getbookingtranscripts
method: GET
description: Get Cal Video real time transcript download links for the booking
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: cal-api-version
in: header
type: string
description: Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.
required: true
- name: bookingUid
in: path
type: string
required: true
- name: Authorization
in: header
type: string
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_ or managed user access
token
required: true
exposes:
- type: rest
namespace: cal-com-bookings-rest
port: 8080
description: REST adapter for Cal.diy API v2 — Bookings. One Spectral-compliant resource per consumed operation, prefixed
with /v1.
resources:
- path: /v1/v2/bookings
name: v2-bookings
description: REST surface for v2-bookings.
operations:
- method: POST
name: bookingscontroller20240813createbooking
description: Create a booking
call: cal-com-bookings.bookingscontroller20240813createbooking
with:
cal-api-version: rest.cal-api-version
Authorization: rest.Authorization
x-cal-secret-key: rest.x-cal-secret-key
x-cal-client-id: rest.x-cal-client-id
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: GET
name: bookingscontroller20240813getbookings
description: Get all bookings
call: cal-com-bookings.bookingscontroller20240813getbookings
with:
cal-api-version: rest.cal-api-version
status: rest.status
attendeeEmail: rest.attendeeEmail
attendeeName: rest.attendeeName
bookingUid: rest.bookingUid
eventTypeIds: rest.eventTypeIds
eventTypeId: rest.eventTypeId
teamsIds: rest.teamsIds
teamId: rest.teamId
afterStart: rest.afterStart
beforeEnd: rest.beforeEnd
afterCreatedAt: rest.afterCreatedAt
beforeCreatedAt: rest.beforeCreatedAt
afterUpdatedAt: rest.afterUpdatedAt
beforeUpdatedAt: rest.beforeUpdatedAt
sortStart: rest.sortStart
sortEnd: rest.sortEnd
sortCreated: rest.sortCreated
sortUpdatedAt: rest.sortUpdatedAt
take: rest.take
skip: rest.skip
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/by-seat/{seatuid}
name: v2-bookings-by-seat-seatuid
description: REST surface for v2-bookings-by-seat-seatUid.
operations:
- method: GET
name: bookingscontroller20240813getbookingbyseatuid
description: Get a booking by seat UID
call: cal-com-bookings.bookingscontroller20240813getbookingbyseatuid
with:
cal-api-version: rest.cal-api-version
seatUid: rest.seatUid
Authorization: rest.Authorization
x-cal-secret-key: rest.x-cal-secret-key
x-cal-client-id: rest.x-cal-client-id
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}
name: v2-bookings-bookinguid
description: REST surface for v2-bookings-bookingUid.
operations:
- method: GET
name: bookingscontroller20240813getbooking
description: Get a booking
call: cal-com-bookings.bookingscontroller20240813getbooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
x-cal-secret-key: rest.x-cal-secret-key
x-cal-client-id: rest.x-cal-client-id
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/calendar-links
name: v2-bookings-bookinguid-calendar-links
description: REST surface for v2-bookings-bookingUid-calendar-links.
operations:
- method: GET
name: bookingscontroller20240813getcalendarlinks
description: Get 'Add to Calendar' links for a booking
call: cal-com-bookings.bookingscontroller20240813getcalendarlinks
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/cancel
name: v2-bookings-bookinguid-cancel
description: REST surface for v2-bookings-bookingUid-cancel.
operations:
- method: POST
name: bookingscontroller20240813cancelbooking
description: Cancel a booking
call: cal-com-bookings.bookingscontroller20240813cancelbooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
x-cal-secret-key: rest.x-cal-secret-key
x-cal-client-id: rest.x-cal-client-id
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/conferencing-sessions
name: v2-bookings-bookinguid-conferencing-sessions
description: REST surface for v2-bookings-bookingUid-conferencing-sessions.
operations:
- method: GET
name: bookingscontroller20240813getvideosessions
description: Get Video Meeting Sessions. Only supported for Cal Video
call: cal-com-bookings.bookingscontroller20240813getvideosessions
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/confirm
name: v2-bookings-bookinguid-confirm
description: REST surface for v2-bookings-bookingUid-confirm.
operations:
- method: POST
name: bookingscontroller20240813confirmbooking
description: Confirm a booking
call: cal-com-bookings.bookingscontroller20240813confirmbooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/decline
name: v2-bookings-bookinguid-decline
description: REST surface for v2-bookings-bookingUid-decline.
operations:
- method: POST
name: bookingscontroller20240813declinebooking
description: Decline a booking
call: cal-com-bookings.bookingscontroller20240813declinebooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/location
name: v2-bookings-bookinguid-location
description: REST surface for v2-bookings-bookingUid-location.
operations:
- method: PATCH
name: bookinglocationcontroller20240813updatebookinglocation
description: Update booking location for an existing booking
call: cal-com-bookings.bookinglocationcontroller20240813updatebookinglocation
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/mark-absent
name: v2-bookings-bookinguid-mark-absent
description: REST surface for v2-bookings-bookingUid-mark-absent.
operations:
- method: POST
name: bookingscontroller20240813marknoshow
description: Mark a booking absence
call: cal-com-bookings.bookingscontroller20240813marknoshow
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/reassign
name: v2-bookings-bookinguid-reassign
description: REST surface for v2-bookings-bookingUid-reassign.
operations:
- method: POST
name: bookingscontroller20240813reassignbooking
description: Reassign a booking to auto-selected host
call: cal-com-bookings.bookingscontroller20240813reassignbooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/reassign/{userid}
name: v2-bookings-bookinguid-reassign-userid
description: REST surface for v2-bookings-bookingUid-reassign-userId.
operations:
- method: POST
name: bookingscontroller20240813reassignbookingtouser
description: Reassign a booking to a specific host
call: cal-com-bookings.bookingscontroller20240813reassignbookingtouser
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
userId: rest.userId
Authorization: rest.Authorization
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/recordings
name: v2-bookings-bookinguid-recordings
description: REST surface for v2-bookings-bookingUid-recordings.
operations:
- method: GET
name: bookingscontroller20240813getbookingrecordings
description: Get all the recordings for the booking
call: cal-com-bookings.bookingscontroller20240813getbookingrecordings
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/references
name: v2-bookings-bookinguid-references
description: REST surface for v2-bookings-bookingUid-references.
operations:
- method: GET
name: bookingscontroller20240813getbookingreferences
description: Get booking references
call: cal-com-bookings.bookingscontroller20240813getbookingreferences
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
type: rest.type
Authorization: rest.Authorization
outputParameters:
- type: object
mapping: $.
- path: /v1/v2/bookings/{bookinguid}/reschedule
name: v2-bookings-bookinguid-reschedule
description: REST surface for v2-bookings-bookingUid-reschedule.
operations:
- method: POST
name: bookingscontroller20240813reschedulebooking
description: Reschedule a booking
call: cal-com-bookings.bookingscontroller20240813reschedulebooking
with:
cal-api-version: rest.cal-api-version
bookingUid: rest.bookingUid
Authorization: rest.Authorizati
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cal-com/refs/heads/main/capabilities/cal-com-bookings.yaml