2021-04-16 13:16:01 +00:00
openapi : 3.0 .0
info :
title : Calendso API
description : The open source Calendly alternative.
contact :
name : Support
2021-09-15 20:35:55 +00:00
email : support@cal.com
2021-04-16 13:16:01 +00:00
license :
name : MIT License
2021-09-23 08:49:17 +00:00
url : "https://opensource.org/licenses/MIT"
2021-08-10 07:03:22 +00:00
version : 1.0 .0
2021-09-23 08:49:17 +00:00
termsOfService : "https://cal.com/terms"
2021-04-16 13:16:01 +00:00
server :
2021-09-23 08:49:17 +00:00
url : "http://localhost:{port}"
2021-04-16 13:16:01 +00:00
description : Local Development Server
variables :
port :
2021-09-23 08:49:17 +00:00
default : "3000"
2021-04-16 13:16:01 +00:00
tags :
- name : Authentication
2021-09-23 08:49:17 +00:00
description : "Auth routes, powered by Next-Auth.js"
2021-04-16 13:16:01 +00:00
externalDocs :
2021-09-23 08:49:17 +00:00
url : "http://next-auth.js.org/"
2021-04-16 13:16:01 +00:00
- name : Availability
description : Checking and setting user availability
- name : Booking
description : Create and manage bookings
- name : Integrations
description : Manage integrations
- name : User
description : Manage the user's profile and settings
2021-08-10 07:03:22 +00:00
- name : Teams
description : Manage teams
2021-04-16 13:16:01 +00:00
paths :
/api/auth/signin :
get :
description : Displays the sign in page.
summary : Displays the sign in page
tags :
- Authentication
2021-09-23 08:49:17 +00:00
"/api/auth/signin/:provider" :
2021-04-16 13:16:01 +00:00
post :
description : Starts an OAuth signin flow for the specified provider. The POST submission requires CSRF token from /api/auth/csrf.
summary : Starts an OAuth signin flow for the specified provider
tags :
- Authentication
2021-09-23 08:49:17 +00:00
"/api/auth/callback/:provider" :
2021-04-16 13:16:01 +00:00
get :
2021-09-23 08:49:17 +00:00
description : "Handles returning requests from OAuth services during sign in. For OAuth 2.0 providers that support the state option, the value of the state parameter is checked against the one that was generated when the sign in flow was started - this uses a hash of the CSRF token which MUST match for both the POST and GET calls during sign in."
2021-04-16 13:16:01 +00:00
summary : Handles returning requests from OAuth services
tags :
- Authentication
/api/auth/signout :
get :
description : Displays the sign out page.
summary : Displays the sign out page
tags :
- Authentication
post :
description : Handles signing out - this is a POST submission to prevent malicious links from triggering signing a user out without their consent. Handles signing out - this is a POST submission to prevent malicious links from triggering signing a user out without their consent.
summary : Handles signing out
tags :
- Authentication
2021-08-10 07:03:22 +00:00
/api/auth/signup :
post :
description : Creates a new user from an invitation.
summary : Create a new user
tags :
- Authentication
2021-04-16 13:16:01 +00:00
/api/auth/session :
get :
description : Returns client-safe session object - or an empty object if there is no session. The contents of the session object that is returned are configurable with the session callback.
summary : Returns client-safe session object
tags :
- Authentication
/api/auth/csrf :
get :
2021-09-04 10:28:05 +00:00
description : 'Returns object containing CSRF token. In NextAuth.js, CSRF protection is present on all authentication routes. It uses the "double submit cookie method", which uses a signed HttpOnly, host-only cookie. The CSRF token returned by this endpoint must be passed as form variable named csrfToken in all POST submissions to any API endpoint.'
2021-04-16 13:16:01 +00:00
summary : Returns object containing CSRF token
tags :
- Authentication
/api/auth/providers :
get :
description : Returns a list of configured OAuth services and details (e.g. sign in and callback URLs) for each service. It can be used to dynamically generate custom sign up pages and to check what callback URLs are configured for each OAuth provider that is configured.
summary : Returns configured OAuth services
tags :
- Authentication
/api/auth/changepw :
post :
description : Changes the password for the currently logged in account.
summary : Changes the password for the currently logged in account
tags :
- Authentication
2021-08-10 07:03:22 +00:00
/api/auth/forgot-password :
post :
description : Send a password reset email.
summary : Send a password reset email
tags :
- Authentication
/api/auth/reset-password :
post :
description : Reset a user's password with their password reset token.
summary : Reset a user's password
tags :
- Authentication
/api/availability/calendar :
get :
description : Gets the user's selected calendars.
summary : Gets the user's selected calendars
tags :
- Availability
2021-09-04 10:28:05 +00:00
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-04 10:28:05 +00:00
description : OK
content :
application/json :
schema :
type : array
2021-09-23 08:49:17 +00:00
description : ""
2021-09-04 10:28:05 +00:00
minItems : 1
uniqueItems : true
items :
type : object
required :
- selected
- externalId
- integration
- name
- primary
properties :
selected :
type : boolean
externalId :
type : string
minLength : 1
integration :
type : string
minLength : 1
name :
type : string
minLength : 1
primary :
type : boolean
x-examples :
example-1 :
- selected : false
externalId : en.uk#holiday@group.v.calendar.google.com
integration : google_calendar
name : Holidays in United Kingdom
- selected : false
externalId : addressbook#contacts@group.v.calendar.google.com
integration : google_calendar
name : Birthdays
- selected : true
2021-09-15 20:35:55 +00:00
externalId : bailey@cal.com
2021-09-04 10:28:05 +00:00
integration : google_calendar
name : Calendso
primary : true
- selected : true
externalId : bpumfleet@gmail.com
integration : google_calendar
name : Personal
- selected : false
externalId : connor@cal.com
integration : google_calendar
name : connor@cal.com
- selected : false
externalId : c_feunmui1m8el5o1oo885fu48k8@group.calendar.google.com
integration : google_calendar
name : 1.0 Launch
2021-09-23 08:49:17 +00:00
"500" :
2021-09-04 10:28:05 +00:00
description : Internal Server Error
2021-08-10 07:03:22 +00:00
post :
description : Adds a selected calendar for the user.
summary : Adds a selected calendar for the user
tags :
- Availability
2021-09-04 10:28:05 +00:00
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-04 10:28:05 +00:00
description : OK
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-04 10:28:05 +00:00
description : Internal Server Error
requestBody :
content :
application/json :
schema :
type : object
properties :
integration :
type : string
externalId :
type : string
2021-08-10 07:03:22 +00:00
delete :
description : Removes a selected calendar for the user.
summary : Removes a selected calendar for the user
tags :
- Availability
2021-09-04 10:28:05 +00:00
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-04 10:28:05 +00:00
description : OK
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-04 10:28:05 +00:00
description : Internal Server Error
requestBody :
content :
application/json :
schema :
type : object
properties :
externalId :
type : string
integration :
type : string
2021-09-23 08:49:17 +00:00
"/api/book/event" :
2021-04-16 13:16:01 +00:00
post :
description : Creates a booking in the user's calendar.
summary : Creates a booking for a user
tags :
- Booking
2021-09-05 10:03:26 +00:00
parameters : [ ]
requestBody :
content :
application/json :
schema :
type : object
properties :
start :
type : string
end :
type : string
rescheduleUid :
type : string
eventTypeId :
type : string
email :
type : string
name :
type : string
timeZone :
type : string
guests :
type : array
items : {}
2021-09-22 18:36:13 +00:00
users :
type : array
items : {}
user :
type : string
2021-09-05 10:03:26 +00:00
notes :
type : string
location :
type : string
2021-09-22 18:36:13 +00:00
paymentUid :
type : string
2021-09-05 10:03:26 +00:00
responses :
2021-09-23 08:49:17 +00:00
"204" :
2021-09-05 10:03:26 +00:00
description : No Content
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
examples : {}
parameters :
- schema :
type : string
name : user
in : path
required : true
description : The user whom you wish to book
2021-08-10 07:03:22 +00:00
/api/book/confirm :
post :
description : Accepts an opt-in booking.
summary : Accepts an opt-in booking
tags :
- Booking
2021-09-05 10:03:26 +00:00
requestBody :
content :
application/json :
schema :
type : object
properties :
id :
type : string
confirmed :
type : string
responses :
2021-09-23 08:49:17 +00:00
"204" :
2021-09-05 10:03:26 +00:00
description : No Content
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
2021-04-16 13:16:01 +00:00
/api/integrations :
get :
description : Gets a list of the user's integrations.
summary : Gets the user's integrations
tags :
- Integrations
2021-09-05 10:03:26 +00:00
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-05 10:03:26 +00:00
description : OK
content :
application/json :
schema :
2021-09-23 08:49:17 +00:00
description : ""
2021-09-05 10:03:26 +00:00
type : object
x-examples :
example-1 :
pageProps :
integrations :
- installed : true
credential :
id : 83
type : google_calendar
key :
2021-09-23 08:49:17 +00:00
scope : "https://www.googleapis.com/auth/calendar.readonly https://www.googleapis.com/auth/calendar.events"
2021-09-05 10:03:26 +00:00
token_type : Bearer
expiry_date : 1630838974808
access_token : ya29.a0ARrdaM89R686rUyBBluTuD69oQ6WIIjjMa2xjJ0qe_5u-9ShDL09KNN1mCYoks3NP54FUMzYKmqTzb8nzCJX9jlNKP7X7-gukO4--HUyfOUbFHlHbfQ2Ei05F8AQn_xS0E_awhDgyn2anvrvEw72U3_65Zi4v6Y
refresh_token : 1 //0dWZWomYrTVUjCgYIARAAGA0SNwF-L9Ir6e5rp9G_nAiwq6PAp37d228O2UfUn-b_LoWk_pTFFKQZ9Cgf_F3u0tJV5h5sDmL1tM4
type : google_calendar
title : Google Calendar
imageSrc : integrations/google-calendar.svg
description : For personal and business calendars
- installed : true
type : office365_calendar
credential : null
title : Office 365 / Outlook.com Calendar
imageSrc : integrations/outlook.svg
description : For personal and business calendars
- installed : true
type : zoom_video
credential : null
title : Zoom
imageSrc : integrations/zoom.svg
description : Video Conferencing
2022-02-04 18:30:52 +00:00
- installed : true
type : tandem_video
credential : null
title : Tandem
imageSrc : integrations/tandem.svg
description : Virtual Office | Video Conferencing
2021-09-05 10:03:26 +00:00
- installed : true
type : caldav_calendar
credential : null
2022-09-20 17:48:20 +00:00
title : CalDav (Beta)
2021-09-05 10:03:26 +00:00
imageSrc : integrations/caldav.svg
description : For personal and business calendars
__N_SSP : true
properties :
pageProps :
type : object
required :
- integrations
properties :
integrations :
type : array
uniqueItems : true
minItems : 1
items :
type : object
properties :
installed :
type : boolean
credential :
type : object
properties :
id :
type : number
type :
type : string
minLength : 1
key :
type : object
required :
- scope
- token_type
- expiry_date
- access_token
- refresh_token
properties :
scope :
type : string
minLength : 1
token_type :
type : string
minLength : 1
expiry_date :
type : number
access_token :
type : string
minLength : 1
refresh_token :
type : string
minLength : 1
required :
- id
- type
- key
type :
type : string
minLength : 1
title :
type : string
minLength : 1
imageSrc :
type : string
minLength : 1
description :
type : string
minLength : 1
required :
- installed
- type
- title
- imageSrc
- description
required :
- pageProps
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-04-16 13:16:01 +00:00
delete :
description : Deletes a user's integration
summary : Deletes a user's integration
tags :
- Integrations
2021-09-05 10:03:26 +00:00
requestBody :
content :
application/json :
schema :
type : object
properties :
id :
type : number
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-05 10:03:26 +00:00
description : OK
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"401" :
2021-09-05 10:03:26 +00:00
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-04-16 13:16:01 +00:00
/api/integrations/googlecalendar/add :
get :
description : Gets the OAuth URL for a Google Calendar integration.
summary : Gets the OAuth URL
tags :
- Integrations
/api/integrations/googlecalendar/callback :
post :
description : Gets and stores the OAuth token for a Google Calendar integration.
summary : Gets and stores the OAuth token
tags :
- Integrations
2021-08-10 07:03:22 +00:00
/api/integrations/office365calendar/add :
get :
description : Gets the OAuth URL for a Microsoft 365/Outlook integration.
summary : Gets the OAuth URL
tags :
- Integrations
/api/integrations/office365calendar/callback :
post :
description : Gets and stores the OAuth token for a Microsoft 365/Outlook integration.
summary : Gets and stores the OAuth token
tags :
- Integrations
/api/integrations/zoomvideo/add :
get :
description : Gets the OAuth URL for a Zoom integration.
summary : Gets the OAuth URL
tags :
- Integrations
/api/integrations/zoomvideo/callback :
post :
description : Gets and stores the OAuth token for a Zoom integration.
summary : Gets and stores the OAuth token
tags :
- Integrations
2022-02-04 18:30:52 +00:00
/api/integrations/tandemvideo/add :
get :
description : Gets the OAuth URL for a Tandem integration.
summary : Gets the OAuth URL
tags :
- Integrations
/api/integrations/tandemvideo/callback :
post :
description : Gets and stores the OAuth token for a Tandem integration.
summary : Gets and stores the OAuth token
tags :
- Integrations
2021-10-05 22:40:03 +00:00
/api/me :
get :
description : Gets current user's profile.
summary : Gets current user's profile.
tags :
- User
responses :
"200" :
2021-09-05 10:03:26 +00:00
description : OK
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"401" :
2021-09-05 10:03:26 +00:00
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"/api/{team}" :
2021-08-10 07:03:22 +00:00
delete :
description : Deletes a team
summary : Deletes a team
tags :
- Teams
2021-09-05 10:03:26 +00:00
parameters : [ ]
responses :
2021-09-23 08:49:17 +00:00
"204" :
2021-09-05 10:03:26 +00:00
description : No Content
2021-09-23 08:49:17 +00:00
"401" :
2021-09-05 10:03:26 +00:00
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
parameters :
- schema :
type : string
name : team
in : path
required : true
description : The team which you wish to modify
2021-09-23 08:49:17 +00:00
"/api/{team}/invite" :
2021-08-10 07:03:22 +00:00
post :
description : Invites someone to a team.
summary : Invites someone to a team
tags :
- Teams
2021-09-05 10:03:26 +00:00
parameters : [ ]
requestBody :
content :
application/json :
schema :
type : object
properties :
usernameOrEmail :
type : string
role :
type : string
sendEmailInvitation :
type : boolean
parameters :
- schema :
type : string
name : team
in : path
required : true
description : The team which you wish to send the invite for
2021-09-23 08:49:17 +00:00
"/api/{team}/membership" :
2021-08-10 07:03:22 +00:00
get :
description : Lists the members of a team.
summary : Lists members of a team
tags :
- Teams
2021-09-05 10:03:26 +00:00
parameters : [ ]
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-05 10:03:26 +00:00
description : OK
content :
application/json :
schema :
type : object
properties :
members :
type : array
items : {}
2021-09-23 08:49:17 +00:00
"401" :
2021-09-05 10:03:26 +00:00
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-08-10 07:03:22 +00:00
delete :
description : Cancels a membership (invite) to a team
summary : Cancels a membership
tags :
- Teams
2021-09-05 10:03:26 +00:00
requestBody :
content :
application/json :
schema :
type : object
properties :
userId :
type : number
responses :
2021-09-23 08:49:17 +00:00
"200" :
2021-09-05 10:03:26 +00:00
description : OK
content :
application/json :
schema :
type : object
properties : {}
2021-09-23 08:49:17 +00:00
"401" :
2021-09-05 10:03:26 +00:00
description : Unauthorized
content :
application/json :
schema :
type : object
properties :
message :
type : string
2021-09-23 08:49:17 +00:00
"500" :
2021-09-05 10:03:26 +00:00
description : Internal Server Error
content :
application/json :
schema :
type : object
properties :
message :
type : string
parameters :
- schema :
type : string
name : team
in : path
required : true
description : The team which you wish to list members of
2021-09-04 10:28:05 +00:00
servers :
2021-09-23 08:49:17 +00:00
- url : "https://app.cal.com"
2021-09-04 10:28:05 +00:00
description : Production
components :
securitySchemes : {}
