{"openapi":"3.0.0","info":{"description":"Scheduling and calendar automation","version":[{"name":"v2","value":"v2"}]},"servers":[{"description":"Scheduling and calendar automation","url":"https://api.apirails.com/cal"}],"paths":{"/v2/api-keys/refresh":{"post":{"tags":["API Keys"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/api-keys/refresh-api-key","api_endpoint":"https://api.cal.com/v2/api-keys/refresh"},"summary":"Refresh API Key","description":"Refresh API Key","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"apiKeyDaysValid":{"type":"number","description":"For how many days is managed organization api key valid. Defaults to 30 days."},"apiKeyNeverExpires":{"type":"boolean","description":"If true, organization api key never expires.","enum":[true,false]}}},"example":{"apiKeyDaysValid":"60","apiKeyNeverExpires":"true"}}}}}},"/v2/bookings/{bookingUid}/attendees":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings-attendees/add-an-attendee-to-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/attendees"},"summary":"Add an attendee to a booking","description":"Add an attendee to a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"The name of the attendee.","required":true},"timeZone":{"type":"string","description":"The time zone of the attendee.","required":true},"phoneNumber":{"type":"string","description":"The phone number of the attendee in international format."},"language":{"type":"string","description":"The preferred language of the attendee. Used for booking confirmation."},"email":{"type":"string","description":"The email of the attendee.","required":true}}},"example":{"name":"John Doe","timeZone":"America/New_York","phoneNumber":"+919876543210","language":"it","email":"john.doe@example.com"}}}}},"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings-attendees/get-all-attendees-for-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/attendees"},"summary":"Get all attendees for a booking","description":"Get all attendees for a booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/attendees/{attendeeId}":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}},{"name":"attendeeId","in":"path","description":"attendeeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings-attendees/get-a-specific-attendee-for-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/attendees/{attendeeId}"},"summary":"Get a specific attendee for a booking","description":"Get a specific attendee for a booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/cancel":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/cancel-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/cancel"},"summary":"Cancel a booking","description":"Cancel a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cancellationReason":{"type":"string","description":"cancellationReason"},"cancelSubsequentBookings":{"type":"boolean","description":"For recurring non-seated booking only - if true, cancel booking with the bookingUid of the individual recurrence and all recurrences that come after it.","enum":[true,false]},"seatUid":{"type":"string","description":"Uid of the specific seat within booking.","required":true}}},"example":{"cancellationReason":"User requested cancellation","cancelSubsequentBookings":"","seatUid":"3be561a9-31f1-4b8e-aefc-9d9a085f0dd1"}}}}}},"/v2/bookings/{bookingUid}/confirm":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/confirm-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/confirm"},"summary":"Confirm a booking","description":"Confirm a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/bookings":{"post":{"tags":["Bookings"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/create-a-booking","api_endpoint":"https://api.cal.com/v2/bookings"},"summary":"Create a booking","description":"Create a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start time of the booking in ISO 8601 format in UTC timezone.","required":true},"attendee":{"type":"object","description":"The attendee's details.","required":true,"properties":{}},"bookingFieldsResponses":{"type":"object","description":"Booking field responses consisting of an object with booking field slug as keys and user response as values for custom booking fields added by you.","properties":{}},"eventTypeId":{"type":"number","description":"The ID of the event type that is booked. Required unless eventTypeSlug and username are provided as an alternative to identifying the event type."},"eventTypeSlug":{"type":"string","description":"The slug of the event type. Required along with username / teamSlug and optionally organizationSlug if eventTypeId is not provided."},"username":{"type":"string","description":"The username of the event owner. Required along with eventTypeSlug and optionally organizationSlug if eventTypeId is not provided."},"teamSlug":{"type":"string","description":"Team slug for team that owns event type for which slots are fetched. Required along with eventTypeSlug and optionally organizationSlug if the team is part of organization"},"organizationSlug":{"type":"string","description":"The organization slug. Optional, only used when booking with eventTypeSlug + username or eventTypeSlug + teamSlug."},"guests":{"type":"array","description":"An optional list of guest emails attending the event.","items":{"type":"string"}},"meetingUrl":{"type":"string","description":"Deprecated - use 'location' instead. Meeting URL just for this booking. Displayed in email and calendar event. If not provided then cal video link will be generated."},"location":{"type":"object","description":"One of the event type locations. If instead of passing one of the location objects as required by schema you are still passing a string please use an object.","properties":{}},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and string values up to 500 characters.","properties":{}},"lengthInMinutes":{"type":"number","description":"If it is an event type that has multiple possible lengths that attendee can pick from, you can pass the desired booking length here.     If not provided then event type default length will be used for the booking."},"routing":{"type":"object","description":"Routing information from routing forms that determined the booking assignment. Both responseId and teamMemberIds are required if provided.","properties":{}},"emailVerificationCode":{"type":"string","description":"Email verification code required when event type has email verification enabled."},"allowConflicts":{"type":"boolean","description":"When true and the authenticated user is a host of the event type, availability conflict checks are bypassed. If the user is not a host or is unauthenticated, this parameter is silently ignored.","enum":[true,false]},"allowBookingOutOfBounds":{"type":"boolean","description":"When true and the authenticated user is a host of the event type, booking time out-of-bounds checks are bypassed allowing bookings outside the normally permitted scheduling window. If the user is not a host or is unauthenticated, this parameter is silently ignored. Only supported on the 2026-02-25 API version.","enum":[true,false]},"instant":{"type":"boolean","description":"Flag indicating if the booking is an instant booking. Only available for team events.","required":true,"enum":[true,false]},"recurrenceCount":{"type":"number","description":"The number of recurrences. If not provided then event type recurrence count will be used. Can't be more than     event type recurrence count"}}},"example":{"start":"2024-08-13T09:00:00Z","attendee":{},"bookingFieldsResponses":"[object Object]","eventTypeId":"123","eventTypeSlug":"my-event-type","username":"john-doe","teamSlug":"john-doe","organizationSlug":"acme-corp","guests":"guest1@example.com,guest2@example.com","meetingUrl":"https://example.com/meeting","location":{},"metadata":"[object Object]","lengthInMinutes":"30","routing":{},"emailVerificationCode":"123456","allowConflicts":"true","allowBookingOutOfBounds":"true","instant":"true","recurrenceCount":"5"}}}}},"get":{"tags":["Bookings"],"parameters":[{"name":"status","in":"query","description":"Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attendeeEmail","in":"query","description":"Filter bookings by the attendee's email address.","required":false,"schema":{"type":"string","example":""}},{"name":"attendeeName","in":"query","description":"Filter bookings by the attendee's name.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUid","in":"query","description":"Filter bookings by the booking Uid.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeIds","in":"query","description":"Filter bookings by event type ids belonging to the user. Event type ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"Filter bookings by event type id belonging to the user.","required":false,"schema":{"type":"string","example":""}},{"name":"teamsIds","in":"query","description":"Filter bookings by team ids that user is part of. Team ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"teamId","in":"query","description":"Filter bookings by team id that user is part of","required":false,"schema":{"type":"string","example":""}},{"name":"afterStart","in":"query","description":"Filter bookings with start after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeEnd","in":"query","description":"Filter bookings with end before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter bookings that have been created after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter bookings that have been created before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter bookings that have been updated after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter bookings that have been updated before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortCreated","in":"query","description":"Sort results by their creation time (when booking was made) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort results by their updated time (for example when booking status changes) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-all-bookings","api_endpoint":"https://api.cal.com/v2/bookings"},"summary":"Get all bookings","description":"Get all bookings","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/decline":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/decline-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/decline"},"summary":"Decline a booking","description":"Decline a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"reason":{"type":"string","description":"Reason for declining a booking that requires a confirmation"}}},"example":{"reason":"Host has to take another call"}}}}}},"/v2/bookings/by-seat/{seatUid}":{"get":{"tags":["Bookings"],"parameters":[{"name":"seatUid","in":"path","description":"seatUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-a-booking-by-seat-uid","api_endpoint":"https://api.cal.com/v2/bookings/by-seat/{seatUid}"},"summary":"Get a booking by seat UID","description":"Get a booking by seat UID","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}"},"summary":"Get a booking","description":"Get a booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/calendar-links":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-add-to-calendar-links-for-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/calendar-links"},"summary":"Get 'Add to Calendar' links for a booking","description":"Get 'Add to Calendar' links for a booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/recordings":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-all-the-recordings-for-the-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/recordings"},"summary":"Get all the recordings for the booking","description":"Get all the recordings for the booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/references":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}},{"name":"type","in":"query","description":"Filter booking references by type","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-booking-references","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/references"},"summary":"Get booking references","description":"Get booking references","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/transcripts":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-cal-video-real-time-transcript-download-links-for-the-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/transcripts"},"summary":"Get Cal Video real time transcript download links for the booking","description":"Get Cal Video real time transcript download links for the booking","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/conferencing-sessions":{"get":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/get-video-meeting-sessions-only-supported-for-cal-video","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/conferencing-sessions"},"summary":"Get Video Meeting Sessions. Only supported for Cal Video","description":"Get Video Meeting Sessions. Only supported for Cal Video","security":[{"bearerAuth":[]}]}},"/v2/bookings/{bookingUid}/guests":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings-guests/add-guests-to-an-existing-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/guests"},"summary":"Add guests to an existing booking","description":"Add guests to an existing booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"guests":{"type":"array","description":"Array of guests to add to the booking. Maximum 10 guests per request.","required":true,"items":{"type":"string"}}}},"example":{"guests":"[object Object],[object Object]"}}}}}},"/v2/bookings/{bookingUid}/mark-absent":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/mark-a-booking-absence","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/mark-absent"},"summary":"Mark a booking absence","description":"Mark a booking absence","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"host":{"type":"boolean","description":"Whether the host was absent","enum":[true,false]},"attendees":{"type":"array","description":"attendees","items":{"type":"string"}}}},"example":{"host":"false","attendees":[]}}}}}},"/v2/bookings/{bookingUid}/reassign/{userId}":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/reassign-a-booking-to-a-specific-host","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/reassign/{userId}"},"summary":"Reassign a booking to a specific host","description":"Reassign a booking to a specific host","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"reason":{"type":"string","description":"Reason for reassigning the booking"}}},"example":{"reason":"Host has to take another call"}}}}}},"/v2/bookings/{bookingUid}/reassign":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/reassign-a-booking-to-auto-selected-host","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/reassign"},"summary":"Reassign a booking to auto-selected host","description":"Reassign a booking to auto-selected host","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/bookings/{bookingUid}/request-reschedule":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/request-to-reschedule-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/request-reschedule"},"summary":"Request to reschedule a booking","description":"Request to reschedule a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"rescheduleReason":{"type":"string","description":"Reason for requesting to reschedule the booking"}}},"example":{"rescheduleReason":"I need to reschedule due to a conflict"}}}}}},"/v2/bookings/{bookingUid}/reschedule":{"post":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/reschedule-a-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/reschedule"},"summary":"Reschedule a booking","description":"Reschedule a booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"Start time in ISO 8601 format for the new booking","required":true},"rescheduledBy":{"type":"string","description":"Email of the person who is rescheduling the booking - only needed when rescheduling a booking that requires a confirmation. If event type owner email is provided then rescheduled booking will be automatically confirmed. If attendee email or no email is passed then the event type owner will have to confirm the rescheduled booking."},"reschedulingReason":{"type":"string","description":"Reason for rescheduling the booking"},"emailVerificationCode":{"type":"string","description":"Email verification code required when event type has email verification enabled."},"seatUid":{"type":"string","description":"Uid of the specific seat within booking.","required":true}}},"example":{"start":"2024-08-13T10:00:00Z","rescheduledBy":"","reschedulingReason":"User requested reschedule","emailVerificationCode":"123456","seatUid":"3be561a9-31f1-4b8e-aefc-9d9a085f0dd1"}}}}}},"/v2/bookings/{bookingUid}/location":{"patch":{"tags":["Bookings"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/bookings/update-booking-location-for-an-existing-booking","api_endpoint":"https://api.cal.com/v2/bookings/{bookingUid}/location"},"summary":"Update booking location for an existing booking","description":"Update booking location for an existing booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"location":{"type":"object","description":"One of the event type locations. If instead of passing one of the location objects as required by schema you are still passing a string please use an object.","properties":{}}}},"example":{"location":{}}}}}}},"/v2/calendars/{calendar}/check":{"get":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/check-a-calendar-connection","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/check"},"summary":"Check a calendar connection","description":"Check a calendar connection","security":[{"bearerAuth":[]}]}},"/v2/calendars/ics-feed/check":{"get":{"tags":["Calendars"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/check-an-ics-feed","api_endpoint":"https://api.cal.com/v2/calendars/ics-feed/check"},"summary":"Check an ICS feed","description":"Check an ICS feed","security":[{"bearerAuth":[]}]}},"/v2/calendars/{calendar}/disconnect":{"post":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/disconnect-a-calendar","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/disconnect"},"summary":"Disconnect a calendar","description":"Disconnect a calendar","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"number","description":"Credential ID of the calendar to delete, as returned by the /calendars endpoint","required":true}}},"example":{"id":"10"}}}}}},"/v2/calendars":{"get":{"tags":["Calendars"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/get-all-calendars","api_endpoint":"https://api.cal.com/v2/calendars"},"summary":"Get all calendars","description":"Get all calendars","security":[{"bearerAuth":[]}]}},"/v2/calendars/busy-times":{"get":{"tags":["Calendars"],"parameters":[{"name":"loggedInUsersTz","in":"query","description":"Deprecated: Use timeZone instead. The timezone of the user represented as a string","required":false,"schema":{"type":"string","example":""}},{"name":"timeZone","in":"query","description":"The timezone for the busy times query represented as a string","required":false,"schema":{"type":"string","example":""}},{"name":"dateFrom","in":"query","description":"The starting date for the busy times query","required":true,"schema":{"type":"string","example":""}},{"name":"dateTo","in":"query","description":"The ending date for the busy times query","required":true,"schema":{"type":"string","example":""}},{"name":"calendarsToLoad","in":"query","description":"An array of Calendar objects representing the calendars to be loaded. Use bracket notation in the URL, e.g.: calendarsToLoad[0][credentialId]=135&calendarsToLoad[0][externalId]=email@example.com","required":true,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/get-busy-times","api_endpoint":"https://api.cal.com/v2/calendars/busy-times"},"summary":"Get busy times","description":"Get busy times","security":[{"bearerAuth":[]}]}},"/v2/calendars/{calendar}/connect":{"get":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}},{"name":"isDryRun","in":"query","description":"isDryRun","required":true,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"redir","in":"query","description":"Redirect URL after successful calendar authorization.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/get-oauth-connect-url","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/connect"},"summary":"Get OAuth connect URL","description":"Get OAuth connect URL","security":[{"bearerAuth":[]}]}},"/v2/calendars/ics-feed/save":{"post":{"tags":["Calendars"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/save-an-ics-feed","api_endpoint":"https://api.cal.com/v2/calendars/ics-feed/save"},"summary":"Save an ICS feed","description":"Save an ICS feed","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"urls":{"type":"array","description":"An array of ICS URLs","required":true,"items":{"type":"string"}},"readOnly":{"type":"boolean","description":"Whether to allowing writing to the calendar or not","enum":[true,false]}}},"example":{"urls":"https://cal.com/ics/feed.ics,http://cal.com/ics/feed.ics","readOnly":"false"}}}}}},"/v2/calendars/{calendar}/credentials":{"post":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/save-apple-calendar-credentials","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/credentials"},"summary":"Save Apple calendar credentials","description":"Save Apple calendar credentials","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"username":{"type":"string","description":"username","required":true},"password":{"type":"string","description":"password","required":true}}},"example":{"username":"","password":""}}}}}},"/v2/calendars/{calendar}/save":{"get":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}},{"name":"state","in":"query","description":"state","required":true,"schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"code","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/calendars/save-google-or-outlook-calendar-credentials","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/save"},"summary":"Save Google or Outlook calendar credentials","description":"Save Google or Outlook calendar credentials","security":[{"bearerAuth":[]}]}},"/v2/calendars/{calendar}/event/{eventUid}":{"get":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}},{"name":"eventUid","in":"path","description":"The Google Calendar event ID. You can retrieve this by getting booking references from the following endpoints:  - For team events: https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-booking-references-for-a-booking  - For user events: https://cal.com/docs/api-reference/v2/bookings/get-booking-references-for-a-booking","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/cal-unified-calendars/get-meeting-details-from-calendar","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/event/{eventUid}"},"summary":"Get meeting details from calendar","description":"Get meeting details from calendar","security":[{"bearerAuth":[]}]}},"/v2/calendars/{calendar}/events/{eventUid}":{"patch":{"tags":["Calendars"],"parameters":[{"name":"calendar","in":"path","description":"calendar","required":true,"schema":{"type":"string","example":""}},{"name":"eventUid","in":"path","description":"The Google Calendar event ID. You can retrieve this by getting booking references from the following endpoints:  - For team events: https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-booking-references-for-a-booking  - For user events: https://cal.com/docs/api-reference/v2/bookings/get-booking-references-for-a-booking","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/cal-unified-calendars/update-meeting-details-in-calendar","api_endpoint":"https://api.cal.com/v2/calendars/{calendar}/events/{eventUid}"},"summary":"Update meeting details in calendar","description":"Update meeting details in calendar","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"object","description":"Start date and time of the calendar event with timezone information","properties":{}},"end":{"type":"object","description":"End date and time of the calendar event with timezone information","properties":{}},"title":{"type":"string","description":"Title of the calendar event"},"description":{"type":"string","description":"Detailed description of the calendar event"},"attendees":{"type":"array","description":"List of attendees. CAUTION: You must pass the entire array with all updated values. Any attendees not included in this array will be removed from the event.","items":{"type":"string"}},"status":{"type":"object","description":"status","properties":{}}}},"example":{"start":{},"end":{},"title":"","description":"","attendees":[],"status":{}}}}}}},"/v2/conferencing/{app}/oauth/callback":{"get":{"tags":["Conferencing"],"parameters":[{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}},{"name":"state","in":"query","description":"state","required":true,"schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"code","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/conferencing-app-oauth-callback","api_endpoint":"https://api.cal.com/v2/conferencing/{app}/oauth/callback"},"summary":"Conferencing app OAuth callback","description":"Conferencing app OAuth callback","security":[{"bearerAuth":[]}]}},"/v2/conferencing/{app}/connect":{"post":{"tags":["Conferencing"],"parameters":[{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/connect-your-conferencing-application","api_endpoint":"https://api.cal.com/v2/conferencing/{app}/connect"},"summary":"Connect your conferencing application","description":"Connect your conferencing application","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/conferencing/{app}/disconnect":{"delete":{"tags":["Conferencing"],"parameters":[{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/disconnect-your-conferencing-application","api_endpoint":"https://api.cal.com/v2/conferencing/{app}/disconnect"},"summary":"Disconnect your conferencing application","description":"Disconnect your conferencing application","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/conferencing/{app}/oauth/auth-url":{"get":{"tags":["Conferencing"],"parameters":[{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}},{"name":"returnTo","in":"query","description":"returnTo","required":true,"schema":{"type":"string","example":""}},{"name":"onErrorReturnTo","in":"query","description":"onErrorReturnTo","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/get-oauth-conferencing-app-auth-url","api_endpoint":"https://api.cal.com/v2/conferencing/{app}/oauth/auth-url"},"summary":"Get OAuth conferencing app auth URL","description":"Get OAuth conferencing app auth URL","security":[{"bearerAuth":[]}]}},"/v2/conferencing/default":{"get":{"tags":["Conferencing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/get-your-default-conferencing-application","api_endpoint":"https://api.cal.com/v2/conferencing/default"},"summary":"Get your default conferencing application","description":"Get your default conferencing application","security":[{"bearerAuth":[]}]}},"/v2/conferencing":{"get":{"tags":["Conferencing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/list-your-conferencing-applications","api_endpoint":"https://api.cal.com/v2/conferencing"},"summary":"List your conferencing applications","description":"List your conferencing applications","security":[{"bearerAuth":[]}]}},"/v2/conferencing/{app}/default":{"post":{"tags":["Conferencing"],"parameters":[{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/conferencing/set-your-default-conferencing-application","api_endpoint":"https://api.cal.com/v2/conferencing/{app}/default"},"summary":"Set your default conferencing application","description":"Set your default conferencing application","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/credits/charge":{"post":{"tags":["Credits"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/credits/charge-credits","api_endpoint":"https://api.cal.com/v2/credits/charge"},"summary":"Charge credits","description":"Charge credits","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"credits":{"type":"number","description":"Number of credits to charge","required":true},"creditFor":{"type":"string","description":"What the credits are being charged for","required":true},"externalRef":{"type":"string","description":"Unique external reference for idempotency"}}},"example":{"credits":"5","creditFor":"AI_AGENT","externalRef":"agent-thread-123-1711432800000"}}}}}},"/v2/credits/available":{"get":{"tags":["Credits"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/credits/check-available-credits","api_endpoint":"https://api.cal.com/v2/credits/available"},"summary":"Check available credits","description":"Check available credits","security":[{"bearerAuth":[]}]}},"/v2/oauth-clients/{clientId}/users":{"post":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/create-a-managed-user","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users"},"summary":"Create a managed user","description":"Create a managed user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"email","required":true},"name":{"type":"string","description":"Managed user's name is used in emails","required":true},"timeFormat":{"type":"number","description":"Must be a number 12 or 24"},"weekStart":{"type":"string","description":"weekStart"},"timeZone":{"type":"string","description":"Timezone is used to create user's default schedule from Monday to Friday from 9AM to 5PM. If it is not passed then user does not have       a default schedule and it must be created manually via the /schedules endpoint. Until the schedule is created, the user can't access availability atom to set his / her availability nor booked.       It will default to Europe/London if not passed."},"locale":{"type":"string","description":"locale"},"avatarUrl":{"type":"string","description":"URL of the user's avatar image"},"bio":{"type":"string","description":"Bio"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and values up to 500 characters.","properties":{}}}},"example":{"email":"alice@example.com","name":"Alice Smith","timeFormat":"12","weekStart":"Monday","timeZone":"America/New_York","locale":"en","avatarUrl":"https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png","bio":"I am a bio","metadata":"[object Object]"}}}}},"get":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"offset","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"emails","in":"query","description":"Filter managed users by email. If you want to filter by multiple emails, separate them with a comma.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/get-all-managed-users","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users"},"summary":"Get all managed users","description":"Get all managed users","security":[{"bearerAuth":[]}]}},"/v2/oauth-clients/{clientId}/users/{userId}":{"delete":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/delete-a-managed-user","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId}"},"summary":"Delete a managed user","description":"Delete a managed user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/get-a-managed-user","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId}"},"summary":"Get a managed user","description":"Get a managed user","security":[{"bearerAuth":[]}]},"patch":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/update-a-managed-user","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId}"},"summary":"Update a managed user","description":"Update a managed user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"email"},"name":{"type":"string","description":"name"},"timeFormat":{"type":"number","description":"Must be 12 or 24"},"defaultScheduleId":{"type":"number","description":"defaultScheduleId"},"weekStart":{"type":"string","description":"weekStart"},"timeZone":{"type":"string","description":"timeZone"},"locale":{"type":"string","description":"locale"},"avatarUrl":{"type":"string","description":"URL of the user's avatar image"},"bio":{"type":"string","description":"Bio"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and values up to 500 characters.","properties":{}}}},"example":{"email":"","name":"","timeFormat":"12","defaultScheduleId":"","weekStart":"Monday","timeZone":"","locale":"en","avatarUrl":"https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png","bio":"I am a bio","metadata":"[object Object]"}}}}}},"/v2/oauth-clients/{clientId}/users/{userId}/force-refresh":{"post":{"tags":["Platform"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/force-refresh-tokens","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId}/force-refresh"},"summary":"Force refresh tokens","description":"Force refresh tokens","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/oauth/{clientId}/refresh":{"post":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-managed-users/refresh-managed-user-tokens","api_endpoint":"https://api.cal.com/v2/oauth/{clientId}/refresh"},"summary":"Refresh managed user tokens","description":"Refresh managed user tokens","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"refreshToken":{"type":"string","description":"Managed user's refresh token.","required":true}}},"example":{"refreshToken":""}}}}}},"/v2/oauth-clients":{"post":{"tags":["Platform"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-oauth-clients/create-an-oauth-client","api_endpoint":"https://api.cal.com/v2/oauth-clients"},"summary":"Create an OAuth client","description":"Create an OAuth client","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"logo":{"type":"string","description":"logo"},"name":{"type":"string","description":"name","required":true},"redirectUris":{"type":"array","description":"redirectUris","required":true,"items":{"type":"string"}},"permissions":{"type":"array","description":"Array of permission keys like [\"BOOKING_READ\", \"BOOKING_WRITE\"]. Use [\"*\"] to grant all permissions.","required":true,"items":{"type":"string"}},"bookingRedirectUri":{"type":"string","description":"bookingRedirectUri"},"bookingCancelRedirectUri":{"type":"string","description":"bookingCancelRedirectUri"},"bookingRescheduleRedirectUri":{"type":"string","description":"bookingRescheduleRedirectUri"},"areEmailsEnabled":{"type":"boolean","description":"areEmailsEnabled","enum":[true,false]},"areDefaultEventTypesEnabled":{"type":"boolean","description":"If true, when creating a managed user the managed user will have 4 default event types: 30 and 60 minutes without Cal video, 30 and 60 minutes with Cal video. Set this as false if you want to create a managed user and then manually create event types for the user.","enum":[true,false]},"areCalendarEventsEnabled":{"type":"boolean","description":"If true and if managed user has calendar connected, calendar events will be created. Disable it if you manually create calendar events. Default to true.","enum":[true,false]}}},"example":{"logo":"","name":"","redirectUris":[],"permissions":[],"bookingRedirectUri":"","bookingCancelRedirectUri":"","bookingRescheduleRedirectUri":"","areEmailsEnabled":"","areDefaultEventTypesEnabled":"","areCalendarEventsEnabled":""}}}}},"get":{"tags":["Platform"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-oauth-clients/get-all-oauth-clients","api_endpoint":"https://api.cal.com/v2/oauth-clients"},"summary":"Get all OAuth clients","description":"Get all OAuth clients","security":[{"bearerAuth":[]}]}},"/v2/oauth-clients/{clientId}":{"delete":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-oauth-clients/delete-an-oauth-client","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}"},"summary":"Delete an OAuth client","description":"Delete an OAuth client","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-oauth-clients/get-an-oauth-client","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}"},"summary":"Get an OAuth client","description":"Get an OAuth client","security":[{"bearerAuth":[]}]},"patch":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-oauth-clients/update-an-oauth-client","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}"},"summary":"Update an OAuth client","description":"Update an OAuth client","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"logo":{"type":"string","description":"logo"},"name":{"type":"string","description":"name"},"redirectUris":{"type":"array","description":"redirectUris","items":{"type":"string"}},"bookingRedirectUri":{"type":"string","description":"bookingRedirectUri"},"bookingCancelRedirectUri":{"type":"string","description":"bookingCancelRedirectUri"},"bookingRescheduleRedirectUri":{"type":"string","description":"bookingRescheduleRedirectUri"},"areEmailsEnabled":{"type":"boolean","description":"areEmailsEnabled","enum":[true,false]},"areDefaultEventTypesEnabled":{"type":"boolean","description":"If true, when creating a managed user the managed user will have 4 default event types: 30 and 60 minutes without Cal video, 30 and 60 minutes with Cal video. Set this as false if you want to create a managed user and then manually create event types for the user.","enum":[true,false]},"areCalendarEventsEnabled":{"type":"boolean","description":"If true and if managed user has calendar connected, calendar events will be created. Disable it if you manually create calendar events. Default to true.","enum":[true,false]}}},"example":{"logo":"","name":"","redirectUris":[],"bookingRedirectUri":"","bookingCancelRedirectUri":"","bookingRescheduleRedirectUri":"","areEmailsEnabled":"","areDefaultEventTypesEnabled":"","areCalendarEventsEnabled":""}}}}}},"/v2/oauth-clients/{clientId}/webhooks":{"post":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/create-a-webhook","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks"},"summary":"Create a webhook","description":"Create a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","required":true,"enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl","required":true},"triggers":{"type":"array","description":"triggers","required":true,"items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}},"delete":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/delete-all-webhooks","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks"},"summary":"Delete all webhooks","description":"Delete all webhooks","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Platform"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/get-all-webhooks","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks"},"summary":"Get all webhooks","description":"Get all webhooks","security":[{"bearerAuth":[]}]}},"/v2/oauth-clients/{clientId}/webhooks/{webhookId}":{"delete":{"tags":["Platform"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/delete-a-webhook","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks/{webhookId}"},"summary":"Delete a webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Platform"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/get-a-webhook","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks/{webhookId}"},"summary":"Get a webhook","description":"Get a webhook","security":[{"bearerAuth":[]}]},"patch":{"tags":["Platform"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/deprecated:-platform-webhooks/update-a-webhook","api_endpoint":"https://api.cal.com/v2/oauth-clients/{clientId}/webhooks/{webhookId}"},"summary":"Update a webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl"},"triggers":{"type":"array","description":"triggers","items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}}},"/v2/destination-calendars":{"put":{"tags":["Calendars"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/destination-calendars/update-destination-calendars","api_endpoint":"https://api.cal.com/v2/destination-calendars"},"summary":"Update destination calendars","description":"Update destination calendars","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"integration":{"type":"string","description":"The calendar service you want to integrate, as returned by the /calendars endpoint","required":true},"externalId":{"type":"string","description":"Unique identifier used to represent the specific calendar, as returned by the /calendars endpoint","required":true},"delegationCredentialId":{"type":"string","description":"delegationCredentialId"}}},"example":{"integration":"apple_calendar","externalId":"https://caldav.icloud.com/26962146906/calendars/1644422A-1945-4438-BBC0-4F0Q23A57R7S/","delegationCredentialId":""}}}}}},"/v2/event-types":{"post":{"tags":["Event Types"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types/create-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types"},"summary":"Create an event type","description":"Create an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes","required":true},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title","required":true},"slug":{"type":"string","description":"slug","required":true},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Custom fields that can be added to the booking form when the event is booked by someone. By default booking form has name and email field.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type. Platform customers can't manage this property because currently we have no way of determining if managed user is a host or an attendee.","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","locations":[]}}}}},"get":{"tags":["Event Types"],"parameters":[{"name":"username","in":"query","description":"The username of the user to get event types for. If only username provided will get all event types.","required":false,"schema":{"type":"string","example":""}},{"name":"eventSlug","in":"query","description":"Slug of event type to return. Notably, if eventSlug is provided then username must be provided too, because multiple users can have event with same slug.","required":false,"schema":{"type":"string","example":""}},{"name":"usernames","in":"query","description":"Get dynamic event type for multiple usernames separated by comma. e.g `usernames=alice,bob`","required":false,"schema":{"type":"string","example":""}},{"name":"orgSlug","in":"query","description":"slug of the user's organization if he is in one, orgId is not required if using this parameter","required":false,"schema":{"type":"string","example":""}},{"name":"orgId","in":"query","description":"ID of the organization of the user you want the get the event-types of, orgSlug is not needed when using this parameter","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort event types by creation date. When not provided, no explicit ordering is applied.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types/get-all-event-types","api_endpoint":"https://api.cal.com/v2/event-types"},"summary":"Get all event types","description":"Get all event types","security":[{"bearerAuth":[]}]}},"/v2/event-types/{eventTypeId}":{"delete":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types/delete-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}"},"summary":"Delete an event type","description":"Delete an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types/get-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}"},"summary":"Get an event type","description":"Get an event type","security":[{"bearerAuth":[]}]},"patch":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types/update-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}"},"summary":"Update an event type","description":"Update an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes"},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title"},"slug":{"type":"string","description":"slug"},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Complete set of booking form fields. This array replaces all existing booking fields. To modify existing fields, first fetch the current event type, then include all desired fields in this array. Sending only one field will remove all other custom fields, keeping only default fields plus the provided one.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","locations":[]}}}}}},"/v2/event-types/{eventTypeId}/private-links":{"post":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-private-links/create-a-private-link-for-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/private-links"},"summary":"Create a private link for an event type","description":"Create a private link for an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"expiresAt":{"type":"string","description":"Expiration date for time-based links"},"maxUsageCount":{"type":"number","description":"Maximum number of times the link can be used. If omitted and expiresAt is not provided, defaults to 1 (one time use)."}}},"example":{"expiresAt":"2024-12-31T23:59:59.000Z","maxUsageCount":"10"}}}}},"get":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-private-links/get-all-private-links-for-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/private-links"},"summary":"Get all private links for an event type","description":"Get all private links for an event type","security":[{"bearerAuth":[]}]}},"/v2/event-types/{eventTypeId}/private-links/{linkId}":{"delete":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"linkId","in":"path","description":"linkId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-private-links/delete-a-private-link-for-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/private-links/{linkId}"},"summary":"Delete a private link for an event type","description":"Delete a private link for an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"linkId","in":"path","description":"linkId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-private-links/update-a-private-link-for-an-event-type","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/private-links/{linkId}"},"summary":"Update a private link for an event type","description":"Update a private link for an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"expiresAt":{"type":"string","description":"New expiration date for time-based links"},"maxUsageCount":{"type":"number","description":"New maximum number of times the link can be used"}}},"example":{"expiresAt":"2024-12-31T23:59:59.000Z","maxUsageCount":"10"}}}}}},"/v2/event-types/{eventTypeId}/webhooks":{"post":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/create-a-webhook","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks"},"summary":"Create a webhook","description":"Create a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","required":true,"enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl","required":true},"triggers":{"type":"array","description":"triggers","required":true,"items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}},"delete":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/delete-all-webhooks","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks"},"summary":"Delete all webhooks","description":"Delete all webhooks","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Event Types"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/get-all-webhooks","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks"},"summary":"Get all webhooks","description":"Get all webhooks","security":[{"bearerAuth":[]}]}},"/v2/event-types/{eventTypeId}/webhooks/{webhookId}":{"delete":{"tags":["Event Types"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/delete-a-webhook","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Delete a webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Event Types"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/get-a-webhook","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Get a webhook","description":"Get a webhook","security":[{"bearerAuth":[]}]},"patch":{"tags":["Event Types"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/event-types-webhooks/update-a-webhook","api_endpoint":"https://api.cal.com/v2/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Update a webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl"},"triggers":{"type":"array","description":"triggers","items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}}},"/v2/organizations/{orgId}/organizations":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/managed-orgs/create-an-organization-within-an-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/organizations"},"summary":"Create an organization within an organization","description":"Create an organization within an organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"apiKeyDaysValid":{"type":"number","description":"For how many days is managed organization api key valid. Defaults to 30 days."},"apiKeyNeverExpires":{"type":"boolean","description":"If true, organization api key never expires.","enum":[true,false]},"name":{"type":"string","description":"Name of the organization","required":true},"slug":{"type":"string","description":"Organization slug in kebab-case - if not provided will be generated automatically based on name."},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}}}},"example":{"apiKeyDaysValid":"60","apiKeyNeverExpires":"true","name":"CalTeam","slug":"cal-tel","metadata":"[object Object]"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"slug","in":"query","description":"The slug of the managed organization","required":false,"schema":{"type":"string","example":""}},{"name":"metadataKey","in":"query","description":"The key of the metadata - it is case sensitive so provide exactly as stored. If you provide it then you must also provide metadataValue","required":false,"schema":{"type":"string","example":""}},{"name":"metadataValue","in":"query","description":"The value of the metadata - it is case sensitive so provide exactly as stored. If you provide it then you must also provide metadataKey","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/managed-orgs/get-all-organizations-within-an-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/organizations"},"summary":"Get all organizations within an organization","description":"Get all organizations within an organization","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/organizations/{managedOrganizationId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"managedOrganizationId","in":"path","description":"managedOrganizationId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/managed-orgs/delete-an-organization-within-an-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/organizations/{managedOrganizationId}"},"summary":"Delete an organization within an organization","description":"Delete an organization within an organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"managedOrganizationId","in":"path","description":"managedOrganizationId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/managed-orgs/get-an-organization-within-an-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/organizations/{managedOrganizationId}"},"summary":"Get an organization within an organization","description":"Get an organization within an organization","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"managedOrganizationId","in":"path","description":"managedOrganizationId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/managed-orgs/update-an-organization-within-an-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/organizations/{managedOrganizationId}"},"summary":"Update an organization within an organization","description":"Update an organization within an organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the organization"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}}}},"example":{"name":"CalTeam","metadata":"[object Object]"}}}}}},"/v2/me":{"get":{"tags":["Profile"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/me/get-my-profile","api_endpoint":"https://api.cal.com/v2/me"},"summary":"Get my profile","description":"Get my profile","security":[{"bearerAuth":[]}]},"patch":{"tags":["Profile"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/me/update-my-profile","api_endpoint":"https://api.cal.com/v2/me"},"summary":"Update my profile","description":"Update my profile","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"email"},"name":{"type":"string","description":"name"},"timeFormat":{"type":"number","description":"Must be 12 or 24"},"defaultScheduleId":{"type":"number","description":"defaultScheduleId"},"weekStart":{"type":"string","description":"weekStart"},"timeZone":{"type":"string","description":"timeZone"},"locale":{"type":"string","description":"locale"},"avatarUrl":{"type":"string","description":"URL of the user's avatar image"},"bio":{"type":"string","description":"Bio"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and values up to 500 characters.","properties":{}}}},"example":{"email":"","name":"","timeFormat":"12","defaultScheduleId":"","weekStart":"Monday","timeZone":"","locale":"en","avatarUrl":"https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png","bio":"I am a bio","metadata":"[object Object]"}}}}}},"/v2/notifications/subscriptions/app-push":{"post":{"tags":["Notifications"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/notifications/register-an-app-push-subscription","api_endpoint":"https://api.cal.com/v2/notifications/subscriptions/app-push"},"summary":"Register an app push subscription","description":"Register an app push subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"token":{"type":"string","description":"Expo Push Token","required":true},"platform":{"type":"string","description":"Mobile platform","required":true},"deviceId":{"type":"string","description":"Unique device identifier","required":true}}},"example":{"token":"ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]","platform":"IOS","deviceId":"device-uuid-123"}}}}},"delete":{"tags":["Notifications"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/notifications/remove-an-app-push-subscription","api_endpoint":"https://api.cal.com/v2/notifications/subscriptions/app-push"},"summary":"Remove an app push subscription","description":"Remove an app push subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/auth/oauth2/token":{"post":{"tags":["OAuth2"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/oauth2/exchange-authorization-code-or-refresh-token-for-tokens","api_endpoint":"https://api.cal.com/v2/auth/oauth2/token"},"summary":"Exchange authorization code or refresh token for tokens","description":"Exchange authorization code or refresh token for tokens","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"client_id":{"type":"string","description":"The client identifier","required":true},"grant_type":{"type":"string","description":"The grant type — must be 'refresh_token'","required":true},"code":{"type":"string","description":"The authorization code received from the authorize endpoint","required":true},"redirect_uri":{"type":"string","description":"The redirect URI used in the authorization request","required":true},"client_secret":{"type":"string","description":"The client secret for confidential clients","required":true},"code_verifier":{"type":"string","description":"PKCE code verifier (required for public clients that used code_challenge)","required":true},"refresh_token":{"type":"string","description":"The refresh token","required":true}}},"example":{"client_id":"my-client-id","grant_type":"refresh_token","code":"abc123","redirect_uri":"https://example.com/callback","client_secret":"","code_verifier":"","refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}}}}}},"/v2/auth/oauth2/clients/{clientId}":{"get":{"tags":["OAuth2"],"parameters":[{"name":"clientId","in":"path","description":"clientId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/oauth2/get-oauth2-client","api_endpoint":"https://api.cal.com/v2/auth/oauth2/clients/{clientId}"},"summary":"Get OAuth2 client","description":"Get OAuth2 client","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/get-list-of-verified-emails-of-an-org-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails"},"summary":"Get list of verified emails of an org team","description":"Get list of verified emails of an org team","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/get-list-of-verified-phone-numbers-of-an-org-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones"},"summary":"Get list of verified phone numbers of an org team","description":"Get list of verified phone numbers of an org team","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/{id}":{"get":{"tags":["Organizations"],"parameters":[{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/get-verified-email-of-an-org-team-by-id","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/{id}"},"summary":"Get verified email of an org team by id","description":"Get verified email of an org team by id","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/{id}":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/get-verified-phone-number-of-an-org-team-by-id","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/{id}"},"summary":"Get verified phone number of an org team by id","description":"Get verified phone number of an org team by id","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/request":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/request-email-verification-code","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/request"},"summary":"Request email verification code","description":"Request email verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true}}},"example":{"email":"acme@example.com"}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/request":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/request-phone-number-verification-code","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/request"},"summary":"Request phone number verification code","description":"Request phone number verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"Phone number to verify.","required":true}}},"example":{"phone":"+372 5555 6666"}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/verify":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/verify-an-email-for-an-org-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/verify"},"summary":"Verify an email for an org team","description":"Verify an email for an org team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true},"code":{"type":"string","description":"verification code sent to the email to verify","required":true}}},"example":{"email":"example@acme.com","code":"1ABG2C"}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/verify":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/organization-team-verified-resources/verify-a-phone-number-for-an-org-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/verify"},"summary":"Verify a phone number for an org team","description":"Verify a phone number for an org team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"phone number to verify.","required":true},"code":{"type":"string","description":"verification code sent to the phone number to verify","required":true}}},"example":{"phone":"+37255556666","code":"1ABG2C"}}}}}},"/v2/organizations/{orgId}/attributes":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes/create-an-attribute","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes"},"summary":"Create an attribute","description":"Create an attribute","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name","required":true},"slug":{"type":"string","description":"slug","required":true},"type":{"type":"string","description":"type","required":true},"options":{"type":"array","description":"options","required":true,"items":{"type":"string"}},"enabled":{"type":"boolean","description":"enabled","enum":[true,false]}}},"example":{"name":"","slug":"","type":"","options":[],"enabled":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes/get-all-attributes","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes"},"summary":"Get all attributes","description":"Get all attributes","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/attributes/{attributeId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes/delete-an-attribute","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}"},"summary":"Delete an attribute","description":"Delete an attribute","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes/get-an-attribute","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}"},"summary":"Get an attribute","description":"Get an attribute","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes/update-an-attribute","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}"},"summary":"Update an attribute","description":"Update an attribute","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name"},"slug":{"type":"string","description":"slug"},"type":{"type":"string","description":"type"},"enabled":{"type":"boolean","description":"enabled","enum":[true,false]}}},"example":{"name":"","slug":"","type":"","enabled":""}}}}}},"/v2/organizations/{orgId}/attributes/options/{userId}":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/assign-an-attribute-to-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/options/{userId}"},"summary":"Assign an attribute to a user","description":"Assign an attribute to a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"value":{"type":"string","description":"value"},"attributeOptionId":{"type":"string","description":"attributeOptionId"},"attributeId":{"type":"string","description":"attributeId","required":true}}},"example":{"value":"","attributeOptionId":"","attributeId":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/get-all-attribute-options-for-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/options/{userId}"},"summary":"Get all attribute options for a user","description":"Get all attribute options for a user","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/attributes/{attributeId}/options":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/create-an-attribute-option","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}/options"},"summary":"Create an attribute option","description":"Create an attribute option","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"value":{"type":"string","description":"value","required":true},"slug":{"type":"string","description":"slug","required":true}}},"example":{"value":"","slug":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/get-all-attribute-options","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}/options"},"summary":"Get all attribute options","description":"Get all attribute options","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/attributes/{attributeId}/options/{optionId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}},{"name":"optionId","in":"path","description":"optionId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/delete-an-attribute-option","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}/options/{optionId}"},"summary":"Delete an attribute option","description":"Delete an attribute option","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}},{"name":"optionId","in":"path","description":"optionId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/update-an-attribute-option","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}/options/{optionId}"},"summary":"Update an attribute option","description":"Update an attribute option","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"value":{"type":"string","description":"value"},"slug":{"type":"string","description":"slug"}}},"example":{"value":"","slug":""}}}}}},"/v2/organizations/{orgId}/attributes/{attributeId}/options/assigned":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeId","in":"path","description":"attributeId","required":true,"schema":{"type":"string","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"assignedOptionIds","in":"query","description":"Filter by assigned attribute option ids. ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"teamIds","in":"query","description":"Filter by teamIds. Team ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/get-all-assigned-attribute-options-by-attribute-id","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/{attributeId}/options/assigned"},"summary":"Get all assigned attribute options by attribute ID","description":"Get all assigned attribute options by attribute ID","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/attributes/slugs/{attributeSlug}/options/assigned":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeSlug","in":"path","description":"attributeSlug","required":true,"schema":{"type":"string","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"assignedOptionIds","in":"query","description":"Filter by assigned attribute option ids. ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"teamIds","in":"query","description":"Filter by teamIds. Team ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/get-all-assigned-attribute-options-by-attribute-slug","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/slugs/{attributeSlug}/options/assigned"},"summary":"Get all assigned attribute options by attribute slug","description":"Get all assigned attribute options by attribute slug","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"attributeOptionId","in":"path","description":"attributeOptionId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-attributes-options/unassign-an-attribute-from-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId}"},"summary":"Unassign an attribute from a user","description":"Unassign an attribute from a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/bookings/block":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-bookings/block-an-organization-booking-attendee","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/bookings/block"},"summary":"Block an organization booking attendee","description":"Block an organization booking attendee","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"bookingUid":{"type":"string","description":"The UID of the booking whose attendee should be blocked","required":true},"blockType":{"type":"string","description":"Whether to block by email or domain. EMAIL blocks the specific booker email. DOMAIN blocks all emails from the same domain.","required":true}}},"example":{"bookingUid":"booking-uid-123","blockType":"EMAIL"}}}}}},"/v2/organizations/{orgId}/bookings":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"status","in":"query","description":"Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attendeeEmail","in":"query","description":"Filter bookings by the attendee's email address.","required":false,"schema":{"type":"string","example":""}},{"name":"attendeeName","in":"query","description":"Filter bookings by the attendee's name.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUid","in":"query","description":"Filter bookings by the booking Uid.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeIds","in":"query","description":"Filter bookings by event type ids belonging to the user. Event type ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"Filter bookings by event type id belonging to the user.","required":false,"schema":{"type":"string","example":""}},{"name":"teamsIds","in":"query","description":"Filter bookings by team ids that user is part of. Team ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"teamId","in":"query","description":"Filter bookings by team id that user is part of","required":false,"schema":{"type":"string","example":""}},{"name":"afterStart","in":"query","description":"Filter bookings with start after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeEnd","in":"query","description":"Filter bookings with end before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter bookings that have been created after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter bookings that have been created before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter bookings that have been updated after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter bookings that have been updated before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortCreated","in":"query","description":"Sort results by their creation time (when booking was made) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort results by their updated time (for example when booking status changes) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"userIds","in":"query","description":"Filter bookings by ids of users within your organization.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-bookings/get-organization-bookings","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/bookings"},"summary":"Get organization bookings","description":"Get organization bookings","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/bookings/report":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-bookings/report-an-organization-booking","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/bookings/report"},"summary":"Report an organization booking","description":"Report an organization booking","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"bookingUid":{"type":"string","description":"The UID of the booking to report","required":true},"reason":{"type":"string","description":"The reason for reporting the booking","required":true},"description":{"type":"string","description":"Additional description for the report"},"reportType":{"type":"string","description":"Whether to report by email or domain. EMAIL targets the specific booker email. DOMAIN targets all emails from the same domain.","required":true}}},"example":{"bookingUid":"booking-uid-123","reason":"SPAM","description":"","reportType":"EMAIL"}}}}}},"/v2/organizations/{orgId}/delegation-credentials":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-delegation-credentials/save-delegation-credentials-for-your-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/delegation-credentials"},"summary":"Save delegation credentials for your organization","description":"Save delegation credentials for your organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"workspacePlatformSlug":{"type":"string","description":"workspacePlatformSlug","required":true},"domain":{"type":"string","description":"domain","required":true},"serviceAccountKey":{"type":"array","description":"serviceAccountKey","required":true,"items":{"type":"string"}}}},"example":{"workspacePlatformSlug":"","domain":"","serviceAccountKey":[]}}}}}},"/v2/organizations/{orgId}/delegation-credentials/{credentialId}":{"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"credentialId","in":"path","description":"credentialId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-delegation-credentials/update-delegation-credentials-of-your-organization","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/delegation-credentials/{credentialId}"},"summary":"Update delegation credentials of your organization","description":"Update delegation credentials of your organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"enabled":{"type":"boolean","description":"enabled","enum":[true,false]},"serviceAccountKey":{"type":"array","description":"serviceAccountKey","items":{"type":"string"}}}},"example":{"enabled":"","serviceAccountKey":[]}}}}}},"/v2/organizations/{orgId}/memberships":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-memberships/create-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/memberships"},"summary":"Create a membership","description":"Create a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"userId":{"type":"number","description":"userId","required":true},"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"If you are platform customer then managed users should only have MEMBER role.","required":true},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"userId":"","accepted":"","role":"","disableImpersonation":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-memberships/get-all-memberships","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/memberships"},"summary":"Get all memberships","description":"Get all memberships","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/memberships/{membershipId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-memberships/delete-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/memberships/{membershipId}"},"summary":"Delete a membership","description":"Delete a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-memberships/get-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/memberships/{membershipId}"},"summary":"Get a membership","description":"Get a membership","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-memberships/update-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/memberships/{membershipId}"},"summary":"Update a membership","description":"Update a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"role"},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"accepted":"","role":"","disableImpersonation":""}}}}}},"/v2/organizations/{orgId}/roles":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles/create-a-new-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles"},"summary":"Create a new organization role","description":"Create a new organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"color":{"type":"string","description":"Color for the role (hex code)"},"description":{"type":"string","description":"Description of the role"},"permissions":{"type":"array","description":"Permissions for this role (format: resource.action). On update, this field replaces the entire permission set for the role (full replace). Use granular permission endpoints for one-by-one changes.","items":{"type":"string"}},"name":{"type":"string","description":"Name of the role","required":true}}},"example":{"color":"","description":"","permissions":"eventType.read,eventType.create,booking.read","name":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles/get-all-organization-roles","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles"},"summary":"Get all organization roles","description":"Get all organization roles","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/roles/{roleId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles/delete-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}"},"summary":"Delete an organization role","description":"Delete an organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles/get-a-specific-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}"},"summary":"Get a specific organization role","description":"Get a specific organization role","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles/update-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}"},"summary":"Update an organization role","description":"Update an organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"color":{"type":"string","description":"Color for the role (hex code)"},"description":{"type":"string","description":"Description of the role"},"permissions":{"type":"array","description":"Permissions for this role (format: resource.action). On update, this field replaces the entire permission set for the role (full replace). Use granular permission endpoints for one-by-one changes.","items":{"type":"string"}},"name":{"type":"string","description":"Name of the role"}}},"example":{"color":"","description":"","permissions":"eventType.read,eventType.create,booking.read","name":""}}}}}},"/v2/organizations/{orgId}/roles/{roleId}/permissions":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles-permissions/add-permissions-to-an-organization-role-single-or-batch","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}/permissions"},"summary":"Add permissions to an organization role (single or batch)","description":"Add permissions to an organization role (single or batch)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"permissions":{"type":"array","description":"Permissions to add (format: resource.action)","required":true,"items":{"type":"string"}}}},"example":{"permissions":"eventType.read,booking.read"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles-permissions/list-permissions-for-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}/permissions"},"summary":"List permissions for an organization role","description":"List permissions for an organization role","security":[{"bearerAuth":[]}]},"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}},{"name":"permissions","in":"query","description":"Permissions to remove (format: resource.action). Supports comma-separated values as well as repeated query params.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles-permissions/remove-multiple-permissions-from-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}/permissions"},"summary":"Remove multiple permissions from an organization role","description":"Remove multiple permissions from an organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"put":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles-permissions/replace-all-permissions-for-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}/permissions"},"summary":"Replace all permissions for an organization role","description":"Replace all permissions for an organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"permissions":{"type":"array","description":"Permissions to add (format: resource.action)","required":true,"items":{"type":"string"}}}},"example":{"permissions":"eventType.read,booking.read"}}}}}},"/v2/organizations/{orgId}/roles/{roleId}/permissions/{permission}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"permission","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-roles-permissions/remove-a-permission-from-an-organization-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/roles/{roleId}/permissions/{permission}"},"summary":"Remove a permission from an organization role","description":"Remove a permission from an organization role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"start","in":"query","description":"Time starting from which available slots should be checked.            Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to start of day or specify hours:       2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"Time until which available slots should be checked.              Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to end of day or specify hours:       2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"timeZone","in":"query","description":"Time zone in which the available slots should be returned. Defaults to UTC.","required":false,"schema":{"type":"string","example":""}},{"name":"duration","in":"query","description":"If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.","required":false,"schema":{"type":"number","example":""}},{"name":"format","in":"query","description":"Format of slot times in response. Use 'range' to get start and end times.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUidToReschedule","in":"query","description":"The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.","required":false,"schema":{"type":"string","example":""}},{"name":"queueResponse","in":"query","description":"Whether to queue the form response.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-routing-forms/create-routing-form-response-and-get-available-slots","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses"},"summary":"Create routing form response and get available slots","description":"Create routing form response and get available slots","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort by creation time","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort by update time","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter by responses created before this date","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter by responses updated before this date","required":false,"schema":{"type":"string","example":""}},{"name":"routedToBookingUid","in":"query","description":"Filter by responses routed to a specific booking","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-routing-forms/get-routing-form-responses","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses"},"summary":"Get routing form responses","description":"Get routing form responses","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/routing-forms":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort by creation time","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort by update time","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter by responses created before this date","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter by responses updated before this date","required":false,"schema":{"type":"string","example":""}},{"name":"routedToBookingUid","in":"query","description":"Filter by responses routed to a specific booking","required":false,"schema":{"type":"string","example":""}},{"name":"teamIds","in":"query","description":"Filter by teamIds. Team ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-routing-forms/get-organization-routing-forms","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/routing-forms"},"summary":"Get organization routing forms","description":"Get organization routing forms","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses/{responseId}":{"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"responseId","in":"path","description":"responseId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-routing-forms/update-routing-form-response","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/routing-forms/{routingFormId}/responses/{responseId}"},"summary":"Update routing form response","description":"Update routing form response","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"response":{"type":"object","description":"The updated response data","properties":{}}}},"example":{"response":{}}}}}}},"/v2/organizations/{orgId}/schedules":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-schedules/get-all-schedules","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/schedules"},"summary":"Get all schedules","description":"Get all schedules","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/bookings/{bookingUid}/references":{"get":{"tags":["Organizations"],"parameters":[{"name":"bookingUid","in":"path","description":"bookingUid","required":true,"schema":{"type":"string","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"type","in":"query","description":"Filter booking references by type","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-booking-references","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/bookings/{bookingUid}/references"},"summary":"Get booking references","description":"Get booking references","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/bookings":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"status","in":"query","description":"Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attendeeEmail","in":"query","description":"Filter bookings by the attendee's email address.","required":false,"schema":{"type":"string","example":""}},{"name":"attendeeName","in":"query","description":"Filter bookings by the attendee's name.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUid","in":"query","description":"Filter bookings by the booking Uid.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeIds","in":"query","description":"Filter bookings by event type ids belonging to the team. Event type ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"Filter bookings by event type id belonging to the team.","required":false,"schema":{"type":"string","example":""}},{"name":"afterStart","in":"query","description":"Filter bookings with start after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeEnd","in":"query","description":"Filter bookings with end before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortCreated","in":"query","description":"Sort results by their creation time (when booking was made) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-bookings/get-organization-team-bookings","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/bookings"},"summary":"Get organization team bookings","description":"Get organization team bookings","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/connect":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/connect-your-conferencing-application-to-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/connect"},"summary":"Connect your conferencing application to a team","description":"Connect your conferencing application to a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/disconnect":{"delete":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/disconnect-team-conferencing-application","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/disconnect"},"summary":"Disconnect team conferencing application","description":"Disconnect team conferencing application","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/auth-url":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}},{"name":"returnTo","in":"query","description":"returnTo","required":true,"schema":{"type":"string","example":""}},{"name":"onErrorReturnTo","in":"query","description":"onErrorReturnTo","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/get-oauth-conferencing-apps-auth-url-for-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/auth-url"},"summary":"Get OAuth conferencing app's auth URL for a team","description":"Get OAuth conferencing app's auth URL for a team","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/default":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/get-team-default-conferencing-application","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/default"},"summary":"Get team default conferencing application","description":"Get team default conferencing application","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/list-team-conferencing-applications","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing"},"summary":"List team conferencing applications","description":"List team conferencing applications","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/callback":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"app","in":"path","description":"app","required":true,"schema":{"type":"string","example":""}},{"name":"state","in":"query","description":"state","required":true,"schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"code","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/save-conferencing-app-oauth-credentials","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/callback"},"summary":"Save conferencing app OAuth credentials","description":"Save conferencing app OAuth credentials","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/default":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"app","in":"path","description":"Conferencing application type","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-conferencing/set-team-default-conferencing-application","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/default"},"summary":"Set team default conferencing application","description":"Set team default conferencing application","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/create-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams"},"summary":"Create a team","description":"Create a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the team","required":true},"slug":{"type":"string","description":"Team slug in kebab-case - if not provided will be generated automatically based on name."},"logoUrl":{"type":"string","description":"URL of the teams logo image"},"calVideoLogo":{"type":"string","description":"calVideoLogo"},"appLogo":{"type":"string","description":"appLogo"},"appIconLogo":{"type":"string","description":"appIconLogo"},"bio":{"type":"string","description":"bio"},"hideBranding":{"type":"boolean","description":"hideBranding","enum":[true,false]},"isPrivate":{"type":"boolean","description":"isPrivate","enum":[true,false]},"hideBookATeamMember":{"type":"boolean","description":"hideBookATeamMember","enum":[true,false]},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}},"theme":{"type":"string","description":"theme"},"brandColor":{"type":"string","description":"brandColor"},"darkBrandColor":{"type":"string","description":"darkBrandColor"},"bannerUrl":{"type":"string","description":"URL of the teams banner image which is shown on booker"},"timeFormat":{"type":"number","description":"timeFormat"},"timeZone":{"type":"string","description":"Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed."},"weekStart":{"type":"string","description":"weekStart"},"autoAcceptCreator":{"type":"boolean","description":"If you are a platform customer, don't pass 'false', because then team creator won't be able to create team event types.","enum":[true,false]}}},"example":{"name":"CalTeam","slug":"caltel","logoUrl":"https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png","calVideoLogo":"","appLogo":"","appIconLogo":"","bio":"","hideBranding":"","isPrivate":"","hideBookATeamMember":"","metadata":"[object Object]","theme":"","brandColor":"","darkBrandColor":"","bannerUrl":"https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png","timeFormat":"","timeZone":"America/New_York","weekStart":"Monday","autoAcceptCreator":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/get-all-teams","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams"},"summary":"Get all teams","description":"Get all teams","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/delete-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}"},"summary":"Delete a team","description":"Delete a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/get-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}"},"summary":"Get a team","description":"Get a team","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/update-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}"},"summary":"Update a team","description":"Update a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the team"},"slug":{"type":"string","description":"Team slug"},"logoUrl":{"type":"string","description":"URL of the teams logo image"},"calVideoLogo":{"type":"string","description":"calVideoLogo"},"appLogo":{"type":"string","description":"appLogo"},"appIconLogo":{"type":"string","description":"appIconLogo"},"bio":{"type":"string","description":"bio"},"hideBranding":{"type":"boolean","description":"hideBranding","enum":[true,false]},"isPrivate":{"type":"boolean","description":"isPrivate","enum":[true,false]},"hideBookATeamMember":{"type":"boolean","description":"hideBookATeamMember","enum":[true,false]},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}},"theme":{"type":"string","description":"theme"},"brandColor":{"type":"string","description":"brandColor"},"darkBrandColor":{"type":"string","description":"darkBrandColor"},"bannerUrl":{"type":"string","description":"URL of the teams banner image which is shown on booker"},"timeFormat":{"type":"number","description":"timeFormat"},"timeZone":{"type":"string","description":"Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed."},"weekStart":{"type":"string","description":"weekStart"},"bookingLimits":{"type":"string","description":"bookingLimits"},"includeManagedEventsInLimits":{"type":"boolean","description":"includeManagedEventsInLimits","enum":[true,false]}}},"example":{"name":"CalTeam","slug":"caltel","logoUrl":"https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png","calVideoLogo":"","appLogo":"","appIconLogo":"","bio":"","hideBranding":"","isPrivate":"","hideBookATeamMember":"","metadata":"[object Object]","theme":"","brandColor":"","darkBrandColor":"","bannerUrl":"https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png","timeFormat":"","timeZone":"America/New_York","weekStart":"Monday","bookingLimits":"","includeManagedEventsInLimits":""}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/event-types":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/create-an-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types"},"summary":"Create an event type","description":"Create an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes","required":true},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title","required":true},"slug":{"type":"string","description":"slug","required":true},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Custom fields that can be added to the booking form when the event is booked by someone. By default booking form has name and email field.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type. Platform customers can't manage this property because currently we have no way of determining if managed user is a host or an attendee.","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"schedulingType":{"type":"string","description":"The scheduling type for the team event - collective, roundRobin or managed.","required":true},"hosts":{"type":"array","description":"Hosts contain specific team members you want to assign to this event type, but if you want to assign all team members, use `assignAllTeamMembers: true` instead and omit this field. For platform customers the hosts can include userIds only of managed users. Provide either hosts or assignAllTeamMembers but not both","items":{"type":"string"}},"assignAllTeamMembers":{"type":"boolean","description":"If true, all current and future team members will be assigned to this event type. Provide either assignAllTeamMembers or hosts but not both","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}},"emailSettings":{"type":"object","description":"Email settings for this event type - only available for organization team event types.","properties":{}},"rescheduleWithSameRoundRobinHost":{"type":"boolean","description":"Rescheduled events will be assigned to the same host as initially scheduled.","enum":[true,false]}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","schedulingType":"collective","hosts":[],"assignAllTeamMembers":"","locations":[],"emailSettings":{},"rescheduleWithSameRoundRobinHost":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"eventSlug","in":"query","description":"Slug of team event type to return.","required":false,"schema":{"type":"string","example":""}},{"name":"hostsLimit","in":"query","description":"Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort event types by creation date. When not provided, no explicit ordering is applied.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/get-team-event-types","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types"},"summary":"Get team event types","description":"Get team event types","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/create-phone-call":{"post":{"tags":["Organizations"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/create-a-phone-call","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/create-phone-call"},"summary":"Create a phone call","description":"Create a phone call","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"yourPhoneNumber":{"type":"string","description":"Your phone number","required":true},"numberToCall":{"type":"string","description":"Number to call","required":true},"calApiKey":{"type":"string","description":"CAL API Key","required":true},"enabled":{"type":"boolean","description":"Enabled status","required":true,"enum":[true,false]},"templateType":{"type":"string","description":"Template type","required":true},"schedulerName":{"type":"string","description":"Scheduler name"},"guestName":{"type":"string","description":"Guest name"},"guestEmail":{"type":"string","description":"Guest email"},"guestCompany":{"type":"string","description":"Guest company"},"beginMessage":{"type":"string","description":"Begin message"},"generalPrompt":{"type":"string","description":"General prompt"}}},"example":{"yourPhoneNumber":"","numberToCall":"","calApiKey":"","enabled":"","templateType":"","schedulerName":"","guestName":"","guestEmail":"","guestCompany":"","beginMessage":"","generalPrompt":""}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/delete-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Delete a team event type","description":"Delete a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/get-an-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Get an event type","description":"Get an event type","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/update-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Update a team event type","description":"Update a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes"},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title"},"slug":{"type":"string","description":"slug"},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Complete set of booking form fields. This array replaces all existing booking fields. To modify existing fields, first fetch the current event type, then include all desired fields in this array. Sending only one field will remove all other custom fields, keeping only default fields plus the provided one.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"schedulingType":{"type":"string","description":"The scheduling type for the team event - collective or roundRobin. ❗If you change scheduling type you must also provide `hosts` or `assignAllTeamMembers` in the request body, otherwise the event type will have no hosts - this is required because       in case of collective event type all hosts are mandatory but in case of round robin some or non can be mandatory so we can't predict how you want the hosts to be setup which is why you must provide that information.  If you want to convert round robin or collective into managed or managed into round robin or collective then you will have to create a new team event type and delete old one."},"hosts":{"type":"array","description":"Hosts contain specific team members you want to assign to this event type, but if you want to assign all team members, use `assignAllTeamMembers: true` instead and omit this field. For platform customers the hosts can include userIds only of managed users. Provide either hosts or assignAllTeamMembers but not both","items":{"type":"string"}},"assignAllTeamMembers":{"type":"boolean","description":"If true, all current and future team members will be assigned to this event type. Provide either assignAllTeamMembers or hosts but not both","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}},"emailSettings":{"type":"object","description":"Email settings for this event type. Only available for organization team event types.","properties":{}},"rescheduleWithSameRoundRobinHost":{"type":"boolean","description":"Rescheduled events will be assigned to the same host as initially scheduled.","enum":[true,false]}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","schedulingType":"collective","hosts":[],"assignAllTeamMembers":"","locations":[],"emailSettings":{},"rescheduleWithSameRoundRobinHost":""}}}}}},"/v2/organizations/{orgId}/teams/event-types":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort event types by creation date. When not provided, no explicit ordering is applied.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types/get-all-team-event-types","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/event-types"},"summary":"Get all team event types","description":"Get all team event types","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types-private-links/create-a-private-link-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links"},"summary":"Create a private link for a team event type","description":"Create a private link for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"expiresAt":{"type":"string","description":"Expiration date for time-based links"},"maxUsageCount":{"type":"number","description":"Maximum number of times the link can be used. If omitted and expiresAt is not provided, defaults to 1 (one time use)."}}},"example":{"expiresAt":"2024-12-31T23:59:59.000Z","maxUsageCount":"10"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types-private-links/get-all-private-links-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links"},"summary":"Get all private links for a team event type","description":"Get all private links for a team event type","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"linkId","in":"path","description":"linkId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types-private-links/delete-a-private-link-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}"},"summary":"Delete a private link for a team event type","description":"Delete a private link for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"linkId","in":"path","description":"linkId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-event-types-private-links/update-a-private-link-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}"},"summary":"Update a private link for a team event type","description":"Update a private link for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams/me":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams/get-teams-membership-for-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/me"},"summary":"Get teams membership for user","description":"Get teams membership for user","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/invite":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-invite/create-team-invite-link","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/invite"},"summary":"Create team invite link","description":"Create team invite link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/memberships":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-memberships/create-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/memberships"},"summary":"Create a membership","description":"Create a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"userId":{"type":"number","description":"userId","required":true},"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"role","required":true},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"userId":"","accepted":"","role":"","disableImpersonation":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-memberships/get-all-memberships","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/memberships"},"summary":"Get all memberships","description":"Get all memberships","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-memberships/delete-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}"},"summary":"Delete a membership","description":"Delete a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-memberships/get-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}"},"summary":"Get a membership","description":"Get a membership","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-memberships/update-a-membership","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}"},"summary":"Update a membership","description":"Update a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"role"},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"accepted":"","role":"","disableImpersonation":""}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/roles":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles/create-a-new-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles"},"summary":"Create a new organization team role","description":"Create a new organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"color":{"type":"string","description":"Color for the role (hex code)"},"description":{"type":"string","description":"Description of the role"},"permissions":{"type":"array","description":"Permissions for this role (format: resource.action). On update, this field replaces the entire permission set for the role (full replace). Use granular permission endpoints for one-by-one changes.","items":{"type":"string"}},"name":{"type":"string","description":"Name of the role","required":true}}},"example":{"color":"","description":"","permissions":"eventType.read,eventType.create,booking.read","name":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles/get-all-organization-team-roles","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles"},"summary":"Get all organization team roles","description":"Get all organization team roles","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles/delete-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}"},"summary":"Delete an organization team role","description":"Delete an organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles/get-a-specific-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}"},"summary":"Get a specific organization team role","description":"Get a specific organization team role","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles/update-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}"},"summary":"Update an organization team role","description":"Update an organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"color":{"type":"string","description":"Color for the role (hex code)"},"description":{"type":"string","description":"Description of the role"},"permissions":{"type":"array","description":"Permissions for this role (format: resource.action). On update, this field replaces the entire permission set for the role (full replace). Use granular permission endpoints for one-by-one changes.","items":{"type":"string"}},"name":{"type":"string","description":"Name of the role"}}},"example":{"color":"","description":"","permissions":"eventType.read,eventType.create,booking.read","name":""}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles-permissions/add-permissions-to-an-organization-team-role-single-or-batch","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions"},"summary":"Add permissions to an organization team role (single or batch)","description":"Add permissions to an organization team role (single or batch)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"permissions":{"type":"array","description":"Permissions to add (format: resource.action)","required":true,"items":{"type":"string"}}}},"example":{"permissions":"eventType.read,booking.read"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles-permissions/list-permissions-for-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions"},"summary":"List permissions for an organization team role","description":"List permissions for an organization team role","security":[{"bearerAuth":[]}]},"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}},{"name":"permissions","in":"query","description":"Permissions to remove (format: resource.action). Supports comma-separated values as well as repeated query params.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles-permissions/remove-multiple-permissions-from-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions"},"summary":"Remove multiple permissions from an organization team role","description":"Remove multiple permissions from an organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"put":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles-permissions/replace-all-permissions-for-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions"},"summary":"Replace all permissions for an organization team role","description":"Replace all permissions for an organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"permissions":{"type":"array","description":"Permissions to add (format: resource.action)","required":true,"items":{"type":"string"}}}},"example":{"permissions":"eventType.read,booking.read"}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions/{permission}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"roleId","in":"path","description":"roleId","required":true,"schema":{"type":"string","example":""}},{"name":"permission","in":"path","description":"permission","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-roles-permissions/remove-a-permission-from-an-organization-team-role","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions/{permission}"},"summary":"Remove a permission from an organization team role","description":"Remove a permission from an organization team role","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/routing-forms":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort by creation time","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort by update time","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter by responses created before this date","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter by responses updated before this date","required":false,"schema":{"type":"string","example":""}},{"name":"routedToBookingUid","in":"query","description":"Filter by responses routed to a specific booking","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-routing-forms/get-team-routing-forms","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/routing-forms"},"summary":"Get team routing forms","description":"Get team routing forms","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"start","in":"query","description":"Time starting from which available slots should be checked.            Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to start of day or specify hours:       2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"Time until which available slots should be checked.              Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to end of day or specify hours:       2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"timeZone","in":"query","description":"Time zone in which the available slots should be returned. Defaults to UTC.","required":false,"schema":{"type":"string","example":""}},{"name":"duration","in":"query","description":"If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.","required":false,"schema":{"type":"number","example":""}},{"name":"format","in":"query","description":"Format of slot times in response. Use 'range' to get start and end times.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUidToReschedule","in":"query","description":"The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.","required":false,"schema":{"type":"string","example":""}},{"name":"queueResponse","in":"query","description":"Whether to queue the form response.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-routing-forms-responses/create-routing-form-response-and-get-available-slots","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses"},"summary":"Create routing form response and get available slots","description":"Create routing form response and get available slots","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of responses to skip","required":false,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Number of responses to take","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort by creation time","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort by update time","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter by responses created before this date","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter by responses created after this date","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter by responses updated before this date","required":false,"schema":{"type":"string","example":""}},{"name":"routedToBookingUid","in":"query","description":"Filter by responses routed to a specific booking","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-routing-forms-responses/get-organization-team-routing-form-responses","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses"},"summary":"Get organization team routing form responses","description":"Get organization team routing form responses","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses/{responseId}":{"patch":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"responseId","in":"path","description":"responseId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-routing-forms-responses/update-routing-form-response","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses/{responseId}"},"summary":"Update routing form response","description":"Update routing form response","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"response":{"type":"object","description":"The updated response data","properties":{}}}},"example":{"response":{}}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/schedules":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"query","description":"Filter schedules by event type ID","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-schedules/get-all-team-member-schedules","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/schedules"},"summary":"Get all team member schedules","description":"Get all team member schedules","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/stripe/check":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-stripe/check-team-stripe-connection","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/stripe/check"},"summary":"Check team Stripe connection","description":"Check team Stripe connection","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/stripe/connect":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"returnTo","in":"query","description":"returnTo","required":true,"schema":{"type":"string","example":""}},{"name":"onErrorReturnTo","in":"query","description":"onErrorReturnTo","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-stripe/get-stripe-connect-url-for-a-team","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/stripe/connect"},"summary":"Get Stripe connect URL for a team","description":"Get Stripe connect URL for a team","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/stripe/save":{"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"state","in":"query","description":"state","required":true,"schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"code","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-stripe/save-stripe-credentials","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/stripe/save"},"summary":"Save Stripe credentials","description":"Save Stripe credentials","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/users/{userId}/schedules":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"query","description":"Filter schedules by event type ID","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-users-schedules/get-schedules-of-a-team-member","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/users/{userId}/schedules"},"summary":"Get schedules of a team member","description":"Get schedules of a team member","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/workflows":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/create-organization-team-workflow-for-event-types","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows"},"summary":"Create organization team workflow for event-types","description":"Create organization team workflow for event-types","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the workflow","required":true},"activation":{"type":"object","description":"Activation settings for the workflow","required":true,"properties":{}},"trigger":{"type":"object","description":"Trigger configuration for the event-type workflow, allowed triggers are beforeEvent,eventCancelled,newEvent,afterEvent,rescheduleEvent,afterHostsCalVideoNoShow,afterGuestsCalVideoNoShow,bookingRejected,bookingRequested,bookingPaymentInitiated,bookingPaid,bookingNoShowUpdated","required":true,"properties":{}},"steps":{"type":"array","description":"Steps to execute as part of the event-type workflow, allowed steps are email_host,email_attendee,email_address,sms_attendee,sms_number,whatsapp_attendee,whatsapp_number,cal_ai_phone_call","required":true,"items":{"type":"string"}}}},"example":{"name":"Platform Test Workflow","activation":{},"trigger":{},"steps":[]}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form":{"post":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/create-organization-team-workflow-for-routing-forms","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form"},"summary":"Create organization team workflow for routing-forms","description":"Create organization team workflow for routing-forms","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the workflow","required":true},"activation":{"type":"object","description":"Activation settings for the workflow","required":true,"properties":{}},"trigger":{"type":"object","description":"Trigger configuration for the routing-form workflow, allowed triggers are formSubmitted,formSubmittedNoEvent","required":true,"properties":{}},"steps":{"type":"array","description":"Steps to execute as part of the routing-form workflow, allowed steps are email_attendee,email_address,sms_attendee,sms_number","required":true,"items":{"type":"string"}}}},"example":{"name":"Platform Test Workflow","activation":{},"trigger":{},"steps":[]}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/get-organization-team-workflows","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form"},"summary":"Get organization team workflows","description":"Get organization team workflows","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form":{"delete":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"workflowId","in":"path","description":"workflowId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/delete-organization-team-routing-form-workflow","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form"},"summary":"Delete organization team routing-form workflow","description":"Delete organization team routing-form workflow","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"workflowId","in":"path","description":"workflowId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/get-organization-team-workflow","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form"},"summary":"Get organization team workflow","description":"Get organization team workflow","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"workflowId","in":"path","description":"workflowId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/update-organization-routing-form-team-workflow","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form"},"summary":"Update organization routing form team workflow","description":"Update organization routing form team workflow","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the workflow"},"trigger":{"type":"object","description":"Trigger configuration for the routing-form workflow, allowed triggers are formSubmitted,formSubmittedNoEvent","properties":{}},"steps":{"type":"array","description":"Steps to execute as part of the routing-form workflow, allowed steps are email_attendee,email_address,sms_attendee,sms_number","items":{"type":"string"}},"activation":{"type":"object","description":"activation","properties":{}}}},"example":{"name":"Rounting-form Test Workflow","trigger":{},"steps":[],"activation":{}}}}}}},"/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"workflowId","in":"path","description":"workflowId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/delete-organization-team-workflow","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}"},"summary":"Delete organization team workflow","description":"Delete organization team workflow","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Organizations"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"workflowId","in":"path","description":"workflowId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-teams-workflows/update-organization-team-workflow","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}"},"summary":"Update organization team workflow","description":"Update organization team workflow","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the workflow"},"activation":{"type":"object","description":"Activation settings for the workflow","properties":{}},"trigger":{"type":"object","description":"Trigger configuration for the event-type workflow, allowed triggers are beforeEvent,eventCancelled,newEvent,afterEvent,rescheduleEvent,afterHostsCalVideoNoShow,afterGuestsCalVideoNoShow,bookingRejected,bookingRequested,bookingPaymentInitiated,bookingPaid,bookingNoShowUpdated","properties":{}},"steps":{"type":"array","description":"Steps to execute as part of the event-type workflow, allowed steps are email_host,email_attendee,email_address,sms_attendee,sms_number,whatsapp_attendee,whatsapp_number,cal_ai_phone_call","items":{"type":"string"}}}},"example":{"name":"Platform Test Workflow","activation":{},"trigger":{},"steps":[]}}}}}},"/v2/organizations/{orgId}/users/{userId}/bookings":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"status","in":"query","description":"Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attendeeEmail","in":"query","description":"Filter bookings by the attendee's email address.","required":false,"schema":{"type":"string","example":""}},{"name":"attendeeName","in":"query","description":"Filter bookings by the attendee's name.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUid","in":"query","description":"Filter bookings by the booking Uid.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeIds","in":"query","description":"Filter bookings by event type ids belonging to the user. Event type ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"Filter bookings by event type id belonging to the user.","required":false,"schema":{"type":"string","example":""}},{"name":"teamsIds","in":"query","description":"Filter bookings by team ids that user is part of. Team ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"teamId","in":"query","description":"Filter bookings by team id that user is part of","required":false,"schema":{"type":"string","example":""}},{"name":"afterStart","in":"query","description":"Filter bookings with start after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeEnd","in":"query","description":"Filter bookings with end before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterCreatedAt","in":"query","description":"Filter bookings that have been created after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeCreatedAt","in":"query","description":"Filter bookings that have been created before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"afterUpdatedAt","in":"query","description":"Filter bookings that have been updated after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeUpdatedAt","in":"query","description":"Filter bookings that have been updated before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortCreated","in":"query","description":"Sort results by their creation time (when booking was made) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortUpdatedAt","in":"query","description":"Sort results by their updated time (for example when booking status changes) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-bookings/get-all-bookings-for-an-organization-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/bookings"},"summary":"Get all bookings for an organization user","description":"Get all bookings for an organization user","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/users":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users/create-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users"},"summary":"Create a user","description":"Create a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"User email address","required":true},"username":{"type":"string","description":"Username"},"weekday":{"type":"string","description":"Preferred weekday"},"brandColor":{"type":"string","description":"Brand color in HEX format"},"bio":{"type":"string","description":"Bio"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and values up to 500 characters.","properties":{}},"darkBrandColor":{"type":"string","description":"Dark brand color in HEX format"},"hideBranding":{"type":"boolean","description":"Hide branding","enum":[true,false]},"timeZone":{"type":"string","description":"Time zone"},"theme":{"type":"string","description":"Theme"},"appTheme":{"type":"string","description":"Application theme"},"timeFormat":{"type":"number","description":"Time format"},"defaultScheduleId":{"type":"number","description":"Default schedule ID"},"locale":{"type":"string","description":"Locale"},"avatarUrl":{"type":"string","description":"Avatar URL"},"organizationRole":{"type":"string","description":"organizationRole"},"autoAccept":{"type":"boolean","description":"Must be true to ensure the organization membership is created in accepted state. If false, the user will have a pending membership and will not be able to access the organization.","enum":[true,false]},"skipNotificationEmail":{"type":"boolean","description":"If true, the signup notification email will not be sent to the new user.","enum":[true,false]}}},"example":{"email":"user@example.com","username":"user123","weekday":"Monday","brandColor":"#FFFFFF","bio":"I am a bio","metadata":"[object Object]","darkBrandColor":"#000000","hideBranding":"false","timeZone":"America/New_York","theme":"dark","appTheme":"light","timeFormat":"24","defaultScheduleId":"1","locale":"en","avatarUrl":"https://example.com/avatar.jpg","organizationRole":"","autoAccept":"","skipNotificationEmail":""}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"emails","in":"query","description":"The email address or an array of email addresses to filter by","required":false,"schema":{"type":"array","example":""}},{"name":"assignedOptionIds","in":"query","description":"Filter by assigned attribute option ids. ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attributeQueryOperator","in":"query","description":"Query operator used to filter assigned options, AND by default.","required":false,"schema":{"type":"string","example":""}},{"name":"teamIds","in":"query","description":"Filter by teamIds. Team ids must be separated by a comma.","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users/get-all-users","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users"},"summary":"Get all users","description":"Get all users","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/users/{userId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users/delete-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}"},"summary":"Delete a user","description":"Delete a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users/update-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}"},"summary":"Update a user","description":"Update a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"User email address"},"username":{"type":"string","description":"Username"},"weekday":{"type":"string","description":"Preferred weekday"},"brandColor":{"type":"string","description":"Brand color in HEX format"},"bio":{"type":"string","description":"Bio"},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters, and values up to 500 characters.","properties":{}},"darkBrandColor":{"type":"string","description":"Dark brand color in HEX format"},"hideBranding":{"type":"boolean","description":"Hide branding","enum":[true,false]},"timeZone":{"type":"string","description":"Time zone"},"theme":{"type":"string","description":"Theme"},"appTheme":{"type":"string","description":"Application theme"},"timeFormat":{"type":"number","description":"Time format"},"defaultScheduleId":{"type":"number","description":"Default schedule ID"},"locale":{"type":"string","description":"Locale"},"avatarUrl":{"type":"string","description":"Avatar URL"}}},"example":{"email":"user@example.com","username":"user123","weekday":"Monday","brandColor":"#FFFFFF","bio":"I am a bio","metadata":"[object Object]","darkBrandColor":"#000000","hideBranding":"false","timeZone":"America/New_York","theme":"dark","appTheme":"light","timeFormat":"24","defaultScheduleId":"1","locale":"en","avatarUrl":"https://example.com/avatar.jpg"}}}}}},"/v2/organizations/{orgId}/users/{userId}/ooo":{"post":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-ooo/create-an-out-of-office-entry-for-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/ooo"},"summary":"Create an out-of-office entry for a user","description":"Create an out-of-office entry for a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-ooo/get-all-out-of-office-entries-for-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/ooo"},"summary":"Get all out-of-office entries for a user","description":"Get all out-of-office entries for a user","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/users/{userId}/ooo/{oooId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-ooo/delete-an-out-of-office-entry-for-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/ooo/{oooId}"},"summary":"Delete an out-of-office entry for a user","description":"Delete an out-of-office entry for a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-ooo/update-an-out-of-office-entry-for-a-user","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/ooo/{oooId}"},"summary":"Update an out-of-office entry for a user","description":"Update an out-of-office entry for a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone."},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone."},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}}},"/v2/organizations/{orgId}/ooo":{"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"email","in":"query","description":"Filter ooo entries by the user email address. user must be within your organization.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-ooo/get-all-out-of-office-entries-for-organization-users","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/ooo"},"summary":"Get all out-of-office entries for organization users","description":"Get all out-of-office entries for organization users","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/users/{userId}/schedules":{"post":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-schedules/create-a-schedule","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/schedules"},"summary":"Create a schedule","description":"Create a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name","required":true},"timeZone":{"type":"string","description":"Timezone is used to calculate available times when an event using the schedule is booked.","required":true},"availability":{"type":"array","description":"Each object contains days and times when the user is available. If not passed, the default availability is Monday to Friday from 09:00 to 17:00.","items":{"type":"string"}},"isDefault":{"type":"boolean","description":"Each user should have 1 default schedule. If you specified `timeZone` when creating managed user, then the default schedule will be created with that timezone.     Default schedule means that if an event type is not tied to a specific schedule then the default schedule is used.","required":true,"enum":[true,false]},"overrides":{"type":"array","description":"Need to change availability for a specific date? Add an override.","items":{"type":"string"}}}},"example":{"name":"Catch up hours","timeZone":"Europe/Rome","availability":"[object Object],[object Object]","isDefault":"true","overrides":"[object Object]"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-schedules/get-all-schedules","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/schedules"},"summary":"Get all schedules","description":"Get all schedules","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-schedules/delete-a-schedule","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}"},"summary":"Delete a schedule","description":"Delete a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-schedules/get-a-schedule","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}"},"summary":"Get a schedule","description":"Get a schedule","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"number","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-users-schedules/update-a-schedule","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}"},"summary":"Update a schedule","description":"Update a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name"},"timeZone":{"type":"string","description":"timeZone"},"availability":{"type":"array","description":"availability","items":{"type":"string"}},"isDefault":{"type":"boolean","description":"isDefault","enum":[true,false]},"overrides":{"type":"array","description":"overrides","items":{"type":"string"}}}},"example":{"name":"One-on-one coaching","timeZone":"Europe/Rome","availability":"[object Object]","isDefault":"true","overrides":"[object Object]"}}}}}},"/v2/organizations/{orgId}/webhooks":{"post":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-webhooks/create-a-webhook","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/webhooks"},"summary":"Create a webhook","description":"Create a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","required":true,"enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl","required":true},"triggers":{"type":"array","description":"triggers","required":true,"items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-webhooks/get-all-webhooks","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/webhooks"},"summary":"Get all webhooks","description":"Get all webhooks","security":[{"bearerAuth":[]}]}},"/v2/organizations/{orgId}/webhooks/{webhookId}":{"delete":{"tags":["Organizations"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-webhooks/delete-a-webhook","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/webhooks/{webhookId}"},"summary":"Delete a webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Organizations"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-webhooks/get-a-webhook","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/webhooks/{webhookId}"},"summary":"Get a webhook","description":"Get a webhook","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"orgId","in":"path","description":"orgId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/orgs-webhooks/update-a-webhook","api_endpoint":"https://api.cal.com/v2/organizations/{orgId}/webhooks/{webhookId}"},"summary":"Update a webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl"},"triggers":{"type":"array","description":"triggers","items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}}},"/v2/me/ooo":{"post":{"tags":["Profile"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/out-of-office/create-an-out-of-office-entry-for-the-authenticated-user","api_endpoint":"https://api.cal.com/v2/me/ooo"},"summary":"Create an out-of-office entry for the authenticated user","description":"Create an out-of-office entry for the authenticated user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}},"get":{"tags":["Profile"],"parameters":[{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/out-of-office/get-all-out-of-office-entries-for-the-authenticated-user","api_endpoint":"https://api.cal.com/v2/me/ooo"},"summary":"Get all out-of-office entries for the authenticated user","description":"Get all out-of-office entries for the authenticated user","security":[{"bearerAuth":[]}]}},"/v2/me/ooo/{oooId}":{"delete":{"tags":["Profile"],"parameters":[{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/out-of-office/delete-an-out-of-office-entry-for-the-authenticated-user","api_endpoint":"https://api.cal.com/v2/me/ooo/{oooId}"},"summary":"Delete an out-of-office entry for the authenticated user","description":"Delete an out-of-office entry for the authenticated user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Profile"],"parameters":[{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/out-of-office/update-an-out-of-office-entry-for-the-authenticated-user","api_endpoint":"https://api.cal.com/v2/me/ooo/{oooId}"},"summary":"Update an out-of-office entry for the authenticated user","description":"Update an out-of-office entry for the authenticated user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone."},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone."},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}}},"/v2/routing-forms/{routingFormId}/calculate-slots":{"post":{"tags":["Routing Forms"],"parameters":[{"name":"routingFormId","in":"path","description":"routingFormId","required":true,"schema":{"type":"string","example":""}},{"name":"start","in":"query","description":"Time starting from which available slots should be checked.            Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to start of day or specify hours:       2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"Time until which available slots should be checked.              Must be in UTC timezone as ISO 8601 datestring.              You can pass date without hours which defaults to end of day or specify hours:       2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z","required":true,"schema":{"type":"string","example":""}},{"name":"timeZone","in":"query","description":"Time zone in which the available slots should be returned. Defaults to UTC.","required":false,"schema":{"type":"string","example":""}},{"name":"duration","in":"query","description":"If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.","required":false,"schema":{"type":"number","example":""}},{"name":"format","in":"query","description":"Format of slot times in response. Use 'range' to get start and end times.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUidToReschedule","in":"query","description":"The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/routing-forms/calculate-slots-based-on-routing-form-response","api_endpoint":"https://api.cal.com/v2/routing-forms/{routingFormId}/calculate-slots"},"summary":"Calculate slots based on routing form response","description":"Calculate slots based on routing form response","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/schedules":{"post":{"tags":["Schedules"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/create-a-schedule","api_endpoint":"https://api.cal.com/v2/schedules"},"summary":"Create a schedule","description":"Create a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name","required":true},"timeZone":{"type":"string","description":"Timezone is used to calculate available times when an event using the schedule is booked.","required":true},"availability":{"type":"array","description":"Each object contains days and times when the user is available. If not passed, the default availability is Monday to Friday from 09:00 to 17:00.","items":{"type":"string"}},"isDefault":{"type":"boolean","description":"Each user should have 1 default schedule. If you specified `timeZone` when creating managed user, then the default schedule will be created with that timezone.     Default schedule means that if an event type is not tied to a specific schedule then the default schedule is used.","required":true,"enum":[true,false]},"overrides":{"type":"array","description":"Need to change availability for a specific date? Add an override.","items":{"type":"string"}}}},"example":{"name":"Catch up hours","timeZone":"Europe/Rome","availability":"[object Object],[object Object]","isDefault":"true","overrides":"[object Object]"}}}}},"get":{"tags":["Schedules"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/get-all-schedules","api_endpoint":"https://api.cal.com/v2/schedules"},"summary":"Get all schedules","description":"Get all schedules","security":[{"bearerAuth":[]}]}},"/v2/schedules/{scheduleId}":{"delete":{"tags":["Schedules"],"parameters":[{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/delete-a-schedule","api_endpoint":"https://api.cal.com/v2/schedules/{scheduleId}"},"summary":"Delete a schedule","description":"Delete a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Schedules"],"parameters":[{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/get-a-schedule","api_endpoint":"https://api.cal.com/v2/schedules/{scheduleId}"},"summary":"Get a schedule","description":"Get a schedule","security":[{"bearerAuth":[]}]},"patch":{"tags":["Schedules"],"parameters":[{"name":"scheduleId","in":"path","description":"scheduleId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/update-a-schedule","api_endpoint":"https://api.cal.com/v2/schedules/{scheduleId}"},"summary":"Update a schedule","description":"Update a schedule","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"name"},"timeZone":{"type":"string","description":"timeZone"},"availability":{"type":"array","description":"availability","items":{"type":"string"}},"isDefault":{"type":"boolean","description":"isDefault","enum":[true,false]},"overrides":{"type":"array","description":"overrides","items":{"type":"string"}}}},"example":{"name":"One-on-one coaching","timeZone":"Europe/Rome","availability":"[object Object]","isDefault":"true","overrides":"[object Object]"}}}}}},"/v2/schedules/default":{"get":{"tags":["Schedules"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/schedules/get-default-schedule","api_endpoint":"https://api.cal.com/v2/schedules/default"},"summary":"Get default schedule","description":"Get default schedule","security":[{"bearerAuth":[]}]}},"/v2/selected-calendars":{"post":{"tags":["Calendars"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/selected-calendars/add-a-selected-calendar","api_endpoint":"https://api.cal.com/v2/selected-calendars"},"summary":"Add a selected calendar","description":"Add a selected calendar","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"integration":{"type":"string","description":"integration","required":true},"externalId":{"type":"string","description":"externalId","required":true},"credentialId":{"type":"number","description":"credentialId","required":true},"delegationCredentialId":{"type":"string","description":"delegationCredentialId"}}},"example":{"integration":"","externalId":"","credentialId":"","delegationCredentialId":""}}}}},"delete":{"tags":["Calendars"],"parameters":[{"name":"integration","in":"query","description":"integration","required":true,"schema":{"type":"string","example":""}},{"name":"externalId","in":"query","description":"externalId","required":true,"schema":{"type":"string","example":""}},{"name":"credentialId","in":"query","description":"credentialId","required":true,"schema":{"type":"string","example":""}},{"name":"delegationCredentialId","in":"query","description":"delegationCredentialId","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/selected-calendars/delete-a-selected-calendar","api_endpoint":"https://api.cal.com/v2/selected-calendars"},"summary":"Delete a selected calendar","description":"Delete a selected calendar","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/slots/reservations/{uid}":{"delete":{"tags":["Slots"],"parameters":[{"name":"uid","in":"path","description":"uid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/slots/delete-a-reserved-slot","api_endpoint":"https://api.cal.com/v2/slots/reservations/{uid}"},"summary":"Delete a reserved slot","description":"Delete a reserved slot","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Slots"],"parameters":[{"name":"uid","in":"path","description":"uid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/slots/get-reserved-slot","api_endpoint":"https://api.cal.com/v2/slots/reservations/{uid}"},"summary":"Get reserved slot","description":"Get reserved slot","security":[{"bearerAuth":[]}]},"patch":{"tags":["Slots"],"parameters":[{"name":"uid","in":"path","description":"uid","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/slots/update-a-reserved-slot","api_endpoint":"https://api.cal.com/v2/slots/reservations/{uid}"},"summary":"Update a reserved slot","description":"Update a reserved slot","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"eventTypeId":{"type":"number","description":"The ID of the event type for which slot should be reserved.","required":true},"slotStart":{"type":"string","description":"ISO 8601 datestring in UTC timezone representing available slot.","required":true},"slotDuration":{"type":"number","description":"By default slot duration is equal to event type length, but if you want to reserve a slot for an event type that has a variable length you can specify it here as a number in minutes. If you don't have this set explicitly that event type can have one of many lengths you can omit this."},"reservationDuration":{"type":"number","description":"ONLY for authenticated requests with api key, access token or OAuth credentials (ID + secret).              For how many minutes the slot should be reserved - for this long time noone else can book this event type at `start` time. If not provided, defaults to 5 minutes."}}},"example":{"eventTypeId":"1","slotStart":"2024-09-04T09:00:00Z","slotDuration":"30","reservationDuration":"5"}}}}}},"/v2/slots":{"get":{"tags":["Slots"],"parameters":[{"name":"bookingUidToReschedule","in":"query","description":"The unique identifier of the booking being rescheduled. When provided will ensure that the original booking time appears within the returned available slots when rescheduling.","required":false,"schema":{"type":"string","example":""}},{"name":"start","in":"query","description":"Time starting from which available slots should be checked.        Must be in UTC timezone as ISO 8601 datestring.        You can pass date without hours which defaults to start of day or specify hours:       2024-08-13 (will have hours 00:00:00 aka at very beginning of the date) or you can specify hours manually like 2024-08-13T09:00:00Z.","required":true,"schema":{"type":"string","example":""}},{"name":"end","in":"query","description":"Time until which available slots should be checked.      Must be in UTC timezone as ISO 8601 datestring.      You can pass date without hours which defaults to end of day or specify hours:     2024-08-20 (will have hours 23:59:59 aka at the very end of the date) or you can specify hours manually like 2024-08-20T18:00:00Z.","required":true,"schema":{"type":"string","example":""}},{"name":"organizationSlug","in":"query","description":"The slug of the organization to which user with username belongs or team with teamSlug belongs.","required":false,"schema":{"type":"string","example":""}},{"name":"teamSlug","in":"query","description":"The slug of the team who owns event type with eventTypeSlug - used when slots are checked for team event type.","required":false,"schema":{"type":"string","example":""}},{"name":"username","in":"query","description":"The username of the user who owns event type with eventTypeSlug - used when slots are checked for individual user event type.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeSlug","in":"query","description":"The slug of the event type for which available slots should be checked. If slug is provided then username or teamSlug must be provided too and if relevant organizationSlug too.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"The ID of the event type for which available slots should be checked.","required":false,"schema":{"type":"number","example":""}},{"name":"usernames","in":"query","description":"The usernames for which available slots should be checked separated by a comma.      Checking slots by usernames is used mainly for dynamic events where there is no specific event but we just want to know when 2 or more people are available.      Must contain at least 2 usernames.","required":false,"schema":{"type":"string","example":""}},{"name":"format","in":"query","description":"Format of slot times in response. Use 'range' to get start and end times. Use 'time' or omit this query parameter to get only start time.","required":false,"schema":{"type":"string","example":""}},{"name":"duration","in":"query","description":"If event type has multiple possible durations then you can specify the desired duration here. Also, if you are fetching slots for a dynamic event then you can specify the duration her which defaults to 30, meaning that returned slots will be each 30 minutes long.","required":false,"schema":{"type":"number","example":""}},{"name":"timeZone","in":"query","description":"Time zone in which the available slots should be returned. Defaults to UTC.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/slots/get-available-time-slots-for-an-event-type","api_endpoint":"https://api.cal.com/v2/slots"},"summary":"Get available time slots for an event type","description":"Get available time slots for an event type","security":[{"bearerAuth":[]}]}},"/v2/slots/reservations":{"post":{"tags":["Slots"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/slots/reserve-a-slot","api_endpoint":"https://api.cal.com/v2/slots/reservations"},"summary":"Reserve a slot","description":"Reserve a slot","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"eventTypeId":{"type":"number","description":"The ID of the event type for which slot should be reserved.","required":true},"slotStart":{"type":"string","description":"ISO 8601 datestring in UTC timezone representing available slot.","required":true},"slotDuration":{"type":"number","description":"By default slot duration is equal to event type length, but if you want to reserve a slot for an event type that has a variable length you can specify it here as a number in minutes. If you don't have this set explicitly that event type can have one of many lengths you can omit this."},"reservationDuration":{"type":"number","description":"ONLY for authenticated requests with api key, access token or OAuth credentials (ID + secret).              For how many minutes the slot should be reserved - for this long time noone else can book this event type at `start` time. If not provided, defaults to 5 minutes."}}},"example":{"eventTypeId":"1","slotStart":"2024-09-04T09:00:00Z","slotDuration":"30","reservationDuration":"5"}}}}}},"/v2/stripe/check":{"get":{"tags":["Stripe"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/stripe/check-stripe-connection","api_endpoint":"https://api.cal.com/v2/stripe/check"},"summary":"Check Stripe connection","description":"Check Stripe connection","security":[{"bearerAuth":[]}]}},"/v2/stripe/connect":{"get":{"tags":["Stripe"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/stripe/get-stripe-connect-url","api_endpoint":"https://api.cal.com/v2/stripe/connect"},"summary":"Get Stripe connect URL","description":"Get Stripe connect URL","security":[{"bearerAuth":[]}]}},"/v2/stripe/save":{"get":{"tags":["Stripe"],"parameters":[{"name":"state","in":"query","description":"state","required":true,"schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"code","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/stripe/save-stripe-credentials","api_endpoint":"https://api.cal.com/v2/stripe/save"},"summary":"Save Stripe credentials","description":"Save Stripe credentials","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/bookings":{"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"status","in":"query","description":"Filter bookings by status. If you want to filter by multiple statuses, separate them with a comma.","required":false,"schema":{"type":"array","example":""}},{"name":"attendeeEmail","in":"query","description":"Filter bookings by the attendee's email address.","required":false,"schema":{"type":"string","example":""}},{"name":"attendeeName","in":"query","description":"Filter bookings by the attendee's name.","required":false,"schema":{"type":"string","example":""}},{"name":"bookingUid","in":"query","description":"Filter bookings by the booking Uid.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeIds","in":"query","description":"Filter bookings by event type ids belonging to the team. Event type ids must be separated by a comma.","required":false,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"query","description":"Filter bookings by event type id belonging to the team.","required":false,"schema":{"type":"string","example":""}},{"name":"afterStart","in":"query","description":"Filter bookings with start after this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"beforeEnd","in":"query","description":"Filter bookings with end before this date string.","required":false,"schema":{"type":"string","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortCreated","in":"query","description":"Sort results by their creation time (when booking was made) in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"take","in":"query","description":"The number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-bookings/get-team-bookings","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/bookings"},"summary":"Get team bookings","description":"Get team bookings","security":[{"bearerAuth":[]}]}},"/v2/teams":{"post":{"tags":["Teams"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams/create-a-team","api_endpoint":"https://api.cal.com/v2/teams"},"summary":"Create a team","description":"Create a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the team","required":true},"slug":{"type":"string","description":"Team slug in kebab-case - if not provided will be generated automatically based on name."},"logoUrl":{"type":"string","description":"URL of the teams logo image"},"calVideoLogo":{"type":"string","description":"calVideoLogo"},"appLogo":{"type":"string","description":"appLogo"},"appIconLogo":{"type":"string","description":"appIconLogo"},"bio":{"type":"string","description":"bio"},"hideBranding":{"type":"boolean","description":"hideBranding","enum":[true,false]},"isPrivate":{"type":"boolean","description":"isPrivate","enum":[true,false]},"hideBookATeamMember":{"type":"boolean","description":"hideBookATeamMember","enum":[true,false]},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}},"theme":{"type":"string","description":"theme"},"brandColor":{"type":"string","description":"brandColor"},"darkBrandColor":{"type":"string","description":"darkBrandColor"},"bannerUrl":{"type":"string","description":"URL of the teams banner image which is shown on booker"},"timeFormat":{"type":"number","description":"timeFormat"},"timeZone":{"type":"string","description":"Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed."},"weekStart":{"type":"string","description":"weekStart"},"autoAcceptCreator":{"type":"boolean","description":"If you are a platform customer, don't pass 'false', because then team creator won't be able to create team event types.","enum":[true,false]}}},"example":{"name":"CalTeam","slug":"caltel","logoUrl":"https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png","calVideoLogo":"","appLogo":"","appIconLogo":"","bio":"","hideBranding":"","isPrivate":"","hideBookATeamMember":"","metadata":"[object Object]","theme":"","brandColor":"","darkBrandColor":"","bannerUrl":"https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png","timeFormat":"","timeZone":"America/New_York","weekStart":"Monday","autoAcceptCreator":""}}}}},"get":{"tags":["Teams"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams/get-teams","api_endpoint":"https://api.cal.com/v2/teams"},"summary":"Get teams","description":"Get teams","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}":{"delete":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams/delete-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}"},"summary":"Delete a team","description":"Delete a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams/get-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}"},"summary":"Get a team","description":"Get a team","security":[{"bearerAuth":[]}]},"patch":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams/update-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}"},"summary":"Update a team","description":"Update a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Name of the team"},"slug":{"type":"string","description":"Team slug"},"logoUrl":{"type":"string","description":"URL of the teams logo image"},"calVideoLogo":{"type":"string","description":"calVideoLogo"},"appLogo":{"type":"string","description":"appLogo"},"appIconLogo":{"type":"string","description":"appIconLogo"},"bio":{"type":"string","description":"bio"},"hideBranding":{"type":"boolean","description":"hideBranding","enum":[true,false]},"isPrivate":{"type":"boolean","description":"isPrivate","enum":[true,false]},"hideBookATeamMember":{"type":"boolean","description":"hideBookATeamMember","enum":[true,false]},"metadata":{"type":"object","description":"You can store any additional data you want here. Metadata must have at most 50 keys, each key up to 40 characters. Values can be strings (up to 500 characters), numbers, or booleans.","properties":{}},"theme":{"type":"string","description":"theme"},"brandColor":{"type":"string","description":"brandColor"},"darkBrandColor":{"type":"string","description":"darkBrandColor"},"bannerUrl":{"type":"string","description":"URL of the teams banner image which is shown on booker"},"timeFormat":{"type":"number","description":"timeFormat"},"timeZone":{"type":"string","description":"Timezone is used to create teams's default schedule from Monday to Friday from 9AM to 5PM. It will default to Europe/London if not passed."},"weekStart":{"type":"string","description":"weekStart"},"bookingLimits":{"type":"string","description":"bookingLimits"},"includeManagedEventsInLimits":{"type":"boolean","description":"includeManagedEventsInLimits","enum":[true,false]}}},"example":{"name":"CalTeam","slug":"caltel","logoUrl":"https://i.cal.com/api/avatar/b0b58752-68ad-4c0d-8024-4fa382a77752.png","calVideoLogo":"","appLogo":"","appIconLogo":"","bio":"","hideBranding":"","isPrivate":"","hideBookATeamMember":"","metadata":"[object Object]","theme":"","brandColor":"","darkBrandColor":"","bannerUrl":"https://i.cal.com/api/avatar/949be534-7a88-4185-967c-c020b0c0bef3.png","timeFormat":"","timeZone":"America/New_York","weekStart":"Monday","bookingLimits":"","includeManagedEventsInLimits":""}}}}}},"/v2/teams/{teamId}/event-types":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/create-an-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types"},"summary":"Create an event type","description":"Create an event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes","required":true},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title","required":true},"slug":{"type":"string","description":"slug","required":true},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Custom fields that can be added to the booking form when the event is booked by someone. By default booking form has name and email field.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type. Platform customers can't manage this property because currently we have no way of determining if managed user is a host or an attendee.","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"schedulingType":{"type":"string","description":"The scheduling type for the team event - collective, roundRobin or managed.","required":true},"hosts":{"type":"array","description":"Hosts contain specific team members you want to assign to this event type, but if you want to assign all team members, use `assignAllTeamMembers: true` instead and omit this field. For platform customers the hosts can include userIds only of managed users. Provide either hosts or assignAllTeamMembers but not both","items":{"type":"string"}},"assignAllTeamMembers":{"type":"boolean","description":"If true, all current and future team members will be assigned to this event type. Provide either assignAllTeamMembers or hosts but not both","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}},"emailSettings":{"type":"object","description":"Email settings for this event type - only available for organization team event types.","properties":{}},"rescheduleWithSameRoundRobinHost":{"type":"boolean","description":"Rescheduled events will be assigned to the same host as initially scheduled.","enum":[true,false]}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","schedulingType":"collective","hosts":[],"assignAllTeamMembers":"","locations":[],"emailSettings":{},"rescheduleWithSameRoundRobinHost":""}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventSlug","in":"query","description":"Slug of team event type to return.","required":false,"schema":{"type":"string","example":""}},{"name":"hostsLimit","in":"query","description":"Specifies the maximum number of hosts to include in the response. This limit helps optimize performance. If not provided, all Hosts will be fetched.","required":false,"schema":{"type":"number","example":""}},{"name":"sortCreatedAt","in":"query","description":"Sort event types by creation date. When not provided, no explicit ordering is applied.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/get-team-event-types","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types"},"summary":"Get team event types","description":"Get team event types","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/create-a-phone-call","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call"},"summary":"Create a phone call","description":"Create a phone call","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"yourPhoneNumber":{"type":"string","description":"Your phone number","required":true},"numberToCall":{"type":"string","description":"Number to call","required":true},"calApiKey":{"type":"string","description":"CAL API Key","required":true},"enabled":{"type":"boolean","description":"Enabled status","required":true,"enum":[true,false]},"templateType":{"type":"string","description":"Template type","required":true},"schedulerName":{"type":"string","description":"Scheduler name"},"guestName":{"type":"string","description":"Guest name"},"guestEmail":{"type":"string","description":"Guest email"},"guestCompany":{"type":"string","description":"Guest company"},"beginMessage":{"type":"string","description":"Begin message"},"generalPrompt":{"type":"string","description":"General prompt"}}},"example":{"yourPhoneNumber":"","numberToCall":"","calApiKey":"","enabled":"","templateType":"","schedulerName":"","guestName":"","guestEmail":"","guestCompany":"","beginMessage":"","generalPrompt":""}}}}}},"/v2/teams/{teamId}/event-types/{eventTypeId}":{"delete":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/delete-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Delete a team event type","description":"Delete a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/get-an-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Get an event type","description":"Get an event type","security":[{"bearerAuth":[]}]},"patch":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types/update-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}"},"summary":"Update a team event type","description":"Update a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"lengthInMinutes":{"type":"number","description":"lengthInMinutes"},"lengthInMinutesOptions":{"type":"array","description":"If you want that user can choose between different lengths of the event you can specify them here. Must include the provided `lengthInMinutes`.","items":{"type":"string"}},"title":{"type":"string","description":"title"},"slug":{"type":"string","description":"slug"},"description":{"type":"string","description":"description"},"bookingFields":{"type":"array","description":"Complete set of booking form fields. This array replaces all existing booking fields. To modify existing fields, first fetch the current event type, then include all desired fields in this array. Sending only one field will remove all other custom fields, keeping only default fields plus the provided one.","items":{"type":"string"}},"disableGuests":{"type":"boolean","description":"If true, person booking this event can't add guests via their emails.","enum":[true,false]},"slotInterval":{"type":"number","description":"Number representing length of each slot when event is booked. By default it equal length of the event type.       If event length is 60 minutes then we would have slots 9AM, 10AM, 11AM etc. but if it was changed to 30 minutes then       we would have slots 9AM, 9:30AM, 10AM, 10:30AM etc. as the available times to book the 60 minute event."},"minimumBookingNotice":{"type":"number","description":"Minimum number of minutes before the event that a booking can be made."},"beforeEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar before a meeting starts. This gives you time to prepare, review notes, or transition from your previous activity."},"afterEventBuffer":{"type":"number","description":"Extra time automatically blocked on your calendar after a meeting ends. This gives you time to wrap up, add notes, or decompress before your next commitment."},"scheduleId":{"type":"number","description":"If you want that this event has different schedule than user's default one you can specify it here."},"bookingLimitsCount":{"type":"object","description":"Limit how many times this event can be booked","properties":{}},"bookerActiveBookingsLimit":{"type":"object","description":"Limit the number of active bookings a booker can make for this event type.","properties":{}},"onlyShowFirstAvailableSlot":{"type":"boolean","description":"This will limit your availability for this event type to one slot per day, scheduled at the earliest available time.","enum":[true,false]},"bookingLimitsDuration":{"type":"object","description":"Limit total amount of time that this event can be booked","properties":{}},"bookingWindow":{"type":"object","description":"Limit how far in the future this event can be booked","properties":{}},"offsetStart":{"type":"number","description":"Offset timeslots shown to bookers by a specified number of minutes"},"bookerLayouts":{"type":"object","description":"Should booker have week, month or column view. Specify default layout and enabled layouts user can pick.","properties":{}},"confirmationPolicy":{"type":"object","description":"Specify how the booking needs to be manually confirmed before it is pushed to the integrations and a confirmation mail is sent.","properties":{}},"recurrence":{"type":"object","description":"Create a recurring event type.","properties":{}},"requiresBookerEmailVerification":{"type":"boolean","description":"requiresBookerEmailVerification","enum":[true,false]},"hideCalendarNotes":{"type":"boolean","description":"hideCalendarNotes","enum":[true,false]},"lockTimeZoneToggleOnBookingPage":{"type":"boolean","description":"lockTimeZoneToggleOnBookingPage","enum":[true,false]},"color":{"type":"object","description":"color","properties":{}},"seats":{"type":"object","description":"Create an event type with multiple seats.","properties":{}},"customName":{"type":"string","description":"Customizable event name with valid variables:       {Event type title}, {Organiser}, {Scheduler}, {Location}, {Organiser first name},       {Scheduler first name}, {Scheduler last name}, {Event duration}, {LOCATION},       {HOST/ATTENDEE}, {HOST}, {ATTENDEE}, {USER}"},"destinationCalendar":{"type":"object","description":"destinationCalendar","properties":{}},"useDestinationCalendarEmail":{"type":"boolean","description":"useDestinationCalendarEmail","enum":[true,false]},"hideCalendarEventDetails":{"type":"boolean","description":"hideCalendarEventDetails","enum":[true,false]},"successRedirectUrl":{"type":"string","description":"A valid URL where the booker will redirect to, once the booking is completed successfully"},"hideOrganizerEmail":{"type":"boolean","description":"Boolean to Hide organizer's email address from the booking screen, email notifications, and calendar events","enum":[true,false]},"calVideoSettings":{"type":"object","description":"Cal video settings for the event type","properties":{}},"hidden":{"type":"boolean","description":"hidden","enum":[true,false]},"bookingRequiresAuthentication":{"type":"boolean","description":"Boolean to require authentication for booking this event type via api. If true, only authenticated users who are the event-type owner or org/team admin/owner can book this event type.","enum":[true,false]},"disableCancelling":{"type":"object","description":"Settings for disabling cancelling of this event type.","properties":{}},"disableRescheduling":{"type":"object","description":"Settings for disabling rescheduling of this event type. Can be always disabled or disabled when less than X minutes before the meeting.","properties":{}},"interfaceLanguage":{"type":"string","description":"Set preferred language for the booking interface. Use empty string for visitor's browser language (default)."},"allowReschedulingPastBookings":{"type":"boolean","description":"Enabling this option allows for past events to be rescheduled.","enum":[true,false]},"allowReschedulingCancelledBookings":{"type":"boolean","description":"When enabled, users will be able to create a new booking when trying to reschedule a cancelled booking.","enum":[true,false]},"showOptimizedSlots":{"type":"boolean","description":"Arrange time slots to optimize availability.","enum":[true,false]},"schedulingType":{"type":"string","description":"The scheduling type for the team event - collective or roundRobin. ❗If you change scheduling type you must also provide `hosts` or `assignAllTeamMembers` in the request body, otherwise the event type will have no hosts - this is required because       in case of collective event type all hosts are mandatory but in case of round robin some or non can be mandatory so we can't predict how you want the hosts to be setup which is why you must provide that information.  If you want to convert round robin or collective into managed or managed into round robin or collective then you will have to create a new team event type and delete old one."},"hosts":{"type":"array","description":"Hosts contain specific team members you want to assign to this event type, but if you want to assign all team members, use `assignAllTeamMembers: true` instead and omit this field. For platform customers the hosts can include userIds only of managed users. Provide either hosts or assignAllTeamMembers but not both","items":{"type":"string"}},"assignAllTeamMembers":{"type":"boolean","description":"If true, all current and future team members will be assigned to this event type. Provide either assignAllTeamMembers or hosts but not both","enum":[true,false]},"locations":{"type":"array","description":"Locations where the event will take place. If not provided, cal video link will be used as the location. Note: Setting a location to a conferencing app does not install the app - the app must already be installed. Via API, only Google Meet (google-meet), Microsoft Teams (office365-video), and Zoom (zoom) can be installed. Cal Video (cal-video) is installed by default. All other conferencing apps must be connected via the Cal.com web app and are not available for Platform plan customers. You can only set an event type location to an app that has already been installed or connected.","items":{"type":"string"}},"emailSettings":{"type":"object","description":"Email settings for this event type. Only available for organization team event types.","properties":{}},"rescheduleWithSameRoundRobinHost":{"type":"boolean","description":"Rescheduled events will be assigned to the same host as initially scheduled.","enum":[true,false]}}},"example":{"lengthInMinutes":"60","lengthInMinutesOptions":"15,30,60","title":"Learn the secrets of masterchief!","slug":"learn-the-secrets-of-masterchief","description":"Discover the culinary wonders of the Argentina by making the best flan ever!","bookingFields":[],"disableGuests":"","slotInterval":"","minimumBookingNotice":"","beforeEventBuffer":"","afterEventBuffer":"","scheduleId":"","bookingLimitsCount":{},"bookerActiveBookingsLimit":{},"onlyShowFirstAvailableSlot":"","bookingLimitsDuration":{},"bookingWindow":{},"offsetStart":"","bookerLayouts":{},"confirmationPolicy":{},"recurrence":{},"requiresBookerEmailVerification":"","hideCalendarNotes":"","lockTimeZoneToggleOnBookingPage":"","color":{},"seats":{},"customName":"{Event type title} between {Organiser} and {Scheduler}","destinationCalendar":{},"useDestinationCalendarEmail":"","hideCalendarEventDetails":"","successRedirectUrl":"https://masterchief.com/argentina/flan/video/9129412","hideOrganizerEmail":"","calVideoSettings":{},"hidden":"","bookingRequiresAuthentication":"","disableCancelling":{},"disableRescheduling":{},"interfaceLanguage":"","allowReschedulingPastBookings":"","allowReschedulingCancelledBookings":"","showOptimizedSlots":"","schedulingType":"collective","hosts":[],"assignAllTeamMembers":"","locations":[],"emailSettings":{},"rescheduleWithSameRoundRobinHost":""}}}}}},"/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks":{"post":{"tags":["Teams"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/create-a-webhook-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks"},"summary":"Create a webhook for a team event type","description":"Create a webhook for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","required":true,"enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl","required":true},"triggers":{"type":"array","description":"triggers","required":true,"items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}},"delete":{"tags":["Teams"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/delete-all-webhooks-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks"},"summary":"Delete all webhooks for a team event type","description":"Delete all webhooks for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/get-all-webhooks-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks"},"summary":"Get all webhooks for a team event type","description":"Get all webhooks for a team event type","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}":{"delete":{"tags":["Teams"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/delete-a-webhook-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Delete a webhook for a team event type","description":"Delete a webhook for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/get-a-webhook-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Get a webhook for a team event type","description":"Get a webhook for a team event type","security":[{"bearerAuth":[]}]},"patch":{"tags":["Teams"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}},{"name":"eventTypeId","in":"path","description":"eventTypeId","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-event-types-webhooks/update-a-webhook-for-a-team-event-type","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}"},"summary":"Update a webhook for a team event type","description":"Update a webhook for a team event type","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl"},"triggers":{"type":"array","description":"triggers","items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}}},"/v2/teams/{teamId}/invite":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-invite/create-team-invite-link","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/invite"},"summary":"Create team invite link","description":"Create team invite link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/teams/{teamId}/memberships":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-memberships/create-a-membership","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/memberships"},"summary":"Create a membership","description":"Create a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"userId":{"type":"number","description":"userId","required":true},"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"role"},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"userId":"","accepted":"","role":"","disableImpersonation":""}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"emails","in":"query","description":"Filter team memberships by email addresses. If you want to filter by multiple emails, separate them with a comma (max 20 emails for performance).","required":false,"schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-memberships/get-all-memberships","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/memberships"},"summary":"Get all memberships","description":"Get all memberships","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/memberships/{membershipId}":{"delete":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-memberships/delete-a-membership","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/memberships/{membershipId}"},"summary":"Delete a membership","description":"Delete a membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-memberships/get-a-membership","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/memberships/{membershipId}"},"summary":"Get a membership","description":"Get a membership","security":[{"bearerAuth":[]}]},"patch":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"membershipId","in":"path","description":"membershipId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-memberships/update-membership","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/memberships/{membershipId}"},"summary":"Update membership","description":"Update membership","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"accepted":{"type":"boolean","description":"accepted","enum":[true,false]},"role":{"type":"string","description":"role"},"disableImpersonation":{"type":"boolean","description":"disableImpersonation","enum":[true,false]}}},"example":{"accepted":"","role":"","disableImpersonation":""}}}}}},"/v2/teams/{teamId}/schedules":{"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-schedules/get-all-team-member-schedules","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/schedules"},"summary":"Get all team member schedules","description":"Get all team member schedules","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/users/{userId}/ooo":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-users-ooo/create-an-out-of-office-entry-for-a-team-member","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/users/{userId}/ooo"},"summary":"Create an out-of-office entry for a team member","description":"Create an out-of-office entry for a team member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone.","required":true},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}},"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}},{"name":"sortStart","in":"query","description":"Sort results by their start time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}},{"name":"sortEnd","in":"query","description":"Sort results by their end time in ascending or descending order.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-users-ooo/get-all-out-of-office-entries-for-a-team-member","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/users/{userId}/ooo"},"summary":"Get all out-of-office entries for a team member","description":"Get all out-of-office entries for a team member","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/users/{userId}/ooo/{oooId}":{"delete":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-users-ooo/delete-an-out-of-office-entry-for-a-team-member","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/users/{userId}/ooo/{oooId}"},"summary":"Delete an out-of-office entry for a team member","description":"Delete an out-of-office entry for a team member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"patch":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"userId","in":"path","description":"userId","required":true,"schema":{"type":"number","example":""}},{"name":"oooId","in":"path","description":"oooId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-users-ooo/update-an-out-of-office-entry-for-a-team-member","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/users/{userId}/ooo/{oooId}"},"summary":"Update an out-of-office entry for a team member","description":"Update an out-of-office entry for a team member","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"start":{"type":"string","description":"The start date and time of the out of office period in ISO 8601 format in UTC timezone."},"end":{"type":"string","description":"The end date and time of the out of office period in ISO 8601 format in UTC timezone."},"notes":{"type":"string","description":"Optional notes for the out of office entry."},"toUserId":{"type":"number","description":"The ID of the user covering for the out of office period, if applicable."},"reason":{"type":"string","description":"the reason for the out of office entry, if applicable"}}},"example":{"start":"2023-05-01T00:00:00.000Z","end":"2023-05-10T23:59:59.999Z","notes":"Vacation in Hawaii","toUserId":"2","reason":"vacation"}}}}}},"/v2/teams/{teamId}/verified-resources/emails":{"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/get-list-of-verified-emails-of-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/emails"},"summary":"Get list of verified emails of a team","description":"Get list of verified emails of a team","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/verified-resources/phones":{"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/get-list-of-verified-phone-numbers-of-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/phones"},"summary":"Get list of verified phone numbers of a team","description":"Get list of verified phone numbers of a team","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/verified-resources/emails/{id}":{"get":{"tags":["Teams"],"parameters":[{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}},{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/get-verified-email-of-a-team-by-id","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/emails/{id}"},"summary":"Get verified email of a team by id","description":"Get verified email of a team by id","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/verified-resources/phones/{id}":{"get":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}},{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/get-verified-phone-number-of-a-team-by-id","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/phones/{id}"},"summary":"Get verified phone number of a team by id","description":"Get verified phone number of a team by id","security":[{"bearerAuth":[]}]}},"/v2/teams/{teamId}/verified-resources/emails/verification-code/request":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/request-email-verification-code","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/emails/verification-code/request"},"summary":"Request email verification code","description":"Request email verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true}}},"example":{"email":"acme@example.com"}}}}}},"/v2/teams/{teamId}/verified-resources/phones/verification-code/request":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/request-phone-number-verification-code","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/phones/verification-code/request"},"summary":"Request phone number verification code","description":"Request phone number verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"Phone number to verify.","required":true}}},"example":{"phone":"+372 5555 6666"}}}}}},"/v2/teams/{teamId}/verified-resources/emails/verification-code/verify":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/verify-an-email-for-a-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/emails/verification-code/verify"},"summary":"Verify an email for a team","description":"Verify an email for a team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true},"code":{"type":"string","description":"verification code sent to the email to verify","required":true}}},"example":{"email":"example@acme.com","code":"1ABG2C"}}}}}},"/v2/teams/{teamId}/verified-resources/phones/verification-code/verify":{"post":{"tags":["Teams"],"parameters":[{"name":"teamId","in":"path","description":"teamId","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/teams-verified-resources/verify-a-phone-number-for-an-org-team","api_endpoint":"https://api.cal.com/v2/teams/{teamId}/verified-resources/phones/verification-code/verify"},"summary":"Verify a phone number for an org team","description":"Verify a phone number for an org team","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"phone number to verify.","required":true},"code":{"type":"string","description":"verification code sent to the phone number to verify","required":true}}},"example":{"phone":"+37255556666","code":"1ABG2C"}}}}}},"/v2/verified-resources/emails":{"get":{"tags":["Verified Resources"],"parameters":[{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/get-list-of-verified-emails","api_endpoint":"https://api.cal.com/v2/verified-resources/emails"},"summary":"Get list of verified emails","description":"Get list of verified emails","security":[{"bearerAuth":[]}]}},"/v2/verified-resources/phones":{"get":{"tags":["Verified Resources"],"parameters":[{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/get-list-of-verified-phone-numbers","api_endpoint":"https://api.cal.com/v2/verified-resources/phones"},"summary":"Get list of verified phone numbers","description":"Get list of verified phone numbers","security":[{"bearerAuth":[]}]}},"/v2/verified-resources/emails/{id}":{"get":{"tags":["Verified Resources"],"parameters":[{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/get-verified-email-by-id","api_endpoint":"https://api.cal.com/v2/verified-resources/emails/{id}"},"summary":"Get verified email by id","description":"Get verified email by id","security":[{"bearerAuth":[]}]}},"/v2/verified-resources/phones/{id}":{"get":{"tags":["Verified Resources"],"parameters":[{"name":"id","in":"path","description":"id","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/get-verified-phone-number-by-id","api_endpoint":"https://api.cal.com/v2/verified-resources/phones/{id}"},"summary":"Get verified phone number by id","description":"Get verified phone number by id","security":[{"bearerAuth":[]}]}},"/v2/verified-resources/emails/verification-code/request":{"post":{"tags":["Verified Resources"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/request-email-verification-code","api_endpoint":"https://api.cal.com/v2/verified-resources/emails/verification-code/request"},"summary":"Request email verification code","description":"Request email verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true}}},"example":{"email":"acme@example.com"}}}}}},"/v2/verified-resources/phones/verification-code/request":{"post":{"tags":["Verified Resources"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/request-phone-number-verification-code","api_endpoint":"https://api.cal.com/v2/verified-resources/phones/verification-code/request"},"summary":"Request phone number verification code","description":"Request phone number verification code","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"Phone number to verify.","required":true}}},"example":{"phone":"+372 5555 6666"}}}}}},"/v2/verified-resources/emails/verification-code/verify":{"post":{"tags":["Verified Resources"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/verify-an-email","api_endpoint":"https://api.cal.com/v2/verified-resources/emails/verification-code/verify"},"summary":"Verify an email","description":"Verify an email","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Email to verify.","required":true},"code":{"type":"string","description":"verification code sent to the email to verify","required":true}}},"example":{"email":"example@acme.com","code":"1ABG2C"}}}}}},"/v2/verified-resources/phones/verification-code/verify":{"post":{"tags":["Verified Resources"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/verified-resources/verify-a-phone-number","api_endpoint":"https://api.cal.com/v2/verified-resources/phones/verification-code/verify"},"summary":"Verify a phone number","description":"Verify a phone number","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"phone":{"type":"string","description":"phone number to verify.","required":true},"code":{"type":"string","description":"verification code sent to the phone number to verify","required":true}}},"example":{"phone":"+37255556666","code":"1ABG2C"}}}}}},"/v2/webhooks":{"post":{"tags":["Webhooks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/webhooks/create-a-webhook","api_endpoint":"https://api.cal.com/v2/webhooks"},"summary":"Create a webhook","description":"Create a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","required":true,"enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl","required":true},"triggers":{"type":"array","description":"triggers","required":true,"items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}},"get":{"tags":["Webhooks"],"parameters":[{"name":"take","in":"query","description":"Maximum number of items to return","required":false,"schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of items to skip","required":false,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/webhooks/get-all-webhooks","api_endpoint":"https://api.cal.com/v2/webhooks"},"summary":"Get all webhooks","description":"Get all webhooks","security":[{"bearerAuth":[]}]}},"/v2/webhooks/{webhookId}":{"delete":{"tags":["Webhooks"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/webhooks/delete-a-webhook","api_endpoint":"https://api.cal.com/v2/webhooks/{webhookId}"},"summary":"Delete a webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Webhooks"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/webhooks/get-a-webhook","api_endpoint":"https://api.cal.com/v2/webhooks/{webhookId}"},"summary":"Get a webhook","description":"Get a webhook","security":[{"bearerAuth":[]}]},"patch":{"tags":["Webhooks"],"parameters":[{"name":"webhookId","in":"path","description":"webhookId","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://cal.com/docs/api-reference/v2/webhooks/update-a-webhook","api_endpoint":"https://api.cal.com/v2/webhooks/{webhookId}"},"summary":"Update a webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"payloadTemplate":{"type":"string","description":"The template of the payload that will be sent to the subscriberUrl, check cal.com/docs/core-features/webhooks for more information"},"active":{"type":"boolean","description":"active","enum":[true,false]},"subscriberUrl":{"type":"string","description":"subscriberUrl"},"triggers":{"type":"array","description":"triggers","items":{"type":"string"}},"secret":{"type":"string","description":"secret"},"version":{"type":"string","description":"The version of the webhook"}}},"example":{"payloadTemplate":"{\"content\":\"A new event has been scheduled\",\"type\":\"{{type}}\",\"name\":\"{{title}}\",\"organizer\":\"{{organizer.name}}\",\"booker\":\"{{attendees.0.name}}\"}","active":"","subscriberUrl":"","triggers":"BOOKING_CREATED,BOOKING_RESCHEDULED,BOOKING_CANCELLED,BOOKING_CONFIRMED,BOOKING_REJECTED,BOOKING_COMPLETED,BOOKING_NO_SHOW,BOOKING_REOPENED","secret":"","version":"2021-10-20"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}