Sign in

v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB
Bookings

Get all the recordings for the booking

Fetches all the recordings for the booking :bookingUid. Requires authentication and proper authorization. Access is granted if you are the booking organizer, team admin or org admin/owner.

<Note>cal-api-version: `2024-08-13` is required in the request header.</Note>
get/v2/bookings/{bookingUid}/recordings

Path parameters

bookingUidstring required

Headers

cal-api-versionstring required

Must be set to 2024-08-13. If not set to this value, the endpoint will default to an older version.

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
errorobject

Example response

{
  "status": "success",
  "data": [
    {
      "id": "1234567890",
      "roomName": "daily-video-room-123",
      "startTs": 1678901234,
      "status": "completed",
      "maxParticipants": 10,
      "duration": 3600,
      "shareToken": "share-token-123",
      "downloadLink": "https://cal-video-recordings.s3.us-east-2.amazonaws.com/meetco/123s",
      "error": "Error message"
    }
  ]
}