v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB

Bookings / Attendees

Remove an attendee from a booking

Remove an attendee from an existing booking by their attendee ID. The primary attendee (first attendee) cannot be removed — to remove them, cancel the booking instead. The removed attendee will receive a cancellation email notification.

<Note>The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error.</Note>

delete/v2/bookings/{bookingUid}/attendees/{attendeeId}

Path parameters

bookingUidstring required

attendeeIdnumber required

Headers

cal-api-versionstring required

Must be set to 2024-08-13. This header is required as this endpoint does not exist in older API versions.

Authorizationstring required

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

Response

status'success' | 'error' required

Example response

{
  "status": "success",
  "data": {
    "id": 123,
    "bookingId": 456,
    "name": "John Doe",
    "email": "john.doe@example.com",
    "timeZone": "America/New_York"
  }
}