v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB

Event Types Private Links

Update a private link for an event type

patch/v2/event-types/{eventTypeId}/private-links/{linkId}

Path parameters

eventTypeIdnumber required

linkIdstring required

Headers

Authorizationstring required

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

Request body

expiresAtstring date-time

New expiration date for time-based links

maxUsageCountnumber

New maximum number of times the link can be used

Example request

{
  "expiresAt": "2024-12-31T23:59:59.000Z",
  "maxUsageCount": 10
}

Response

statusstring required

Response status

Example response

{
  "status": "success",
  "data": {
    "linkId": "abc123def456",
    "eventTypeId": 123,
    "bookingUrl": "https://cal.com/d/abc123def456/30min",
    "expiresAt": "2025-12-31T23:59:59.000Z"
  }
}