Getting Started
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Bookings
Orgs / Delegation Credentials
Orgs / Memberships
Orgs / Orgs
Orgs / Routing forms
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Event Types
Orgs / Teams / Memberships
Orgs / Teams / Routing forms
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Users / Schedules
Orgs / Users / Bookings
Orgs / Users / OOO
Orgs / Users / Schedules
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence - provided authorization header refers to owner of the booking.
- POSTAutomatically reassign booking to a new host automatically - provided authorization header refers to person who reassigned the booking.
- POSTReassign a booking to a specific user specified by the :userId - provided authorization header refers to person who reassigned the booking.
- POSTConfirm booking that requires a confirmation - provided authorization header refers to owner of the booking.
- POSTDecline booking that requires a confirmation - provided authorization header refers to owner of the booking.
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Organizations/Teams Conferencing
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Teams
Delete a team
DELETE
/
v2
/
teams
/
{teamId}
curl --request DELETE \
--url https://api.cal.com/v2/teams/{teamId} \
--header 'Authorization: <authorization>'
{
"status": "success",
"data": {
"id": 123,
"parentId": 123,
"name": "<string>",
"slug": "<string>",
"logoUrl": "<string>",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": true,
"isOrganization": true,
"isPrivate": true,
"hideBookATeamMember": false,
"metadata": {
"key": "value"
},
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "<string>",
"timeFormat": 123,
"timeZone": "Europe/London",
"weekStart": "Sunday"
}
}
Headers
value must be Bearer <token>
where <token>
is api key prefixed with cal_
Path Parameters
Response
200 - application/json
Available options:
success
, error
Example:
"success"
Minimum length:
1
Example:
{ "key": "value" }
Was this page helpful?
curl --request DELETE \
--url https://api.cal.com/v2/teams/{teamId} \
--header 'Authorization: <authorization>'
{
"status": "success",
"data": {
"id": 123,
"parentId": 123,
"name": "<string>",
"slug": "<string>",
"logoUrl": "<string>",
"calVideoLogo": "<string>",
"appLogo": "<string>",
"appIconLogo": "<string>",
"bio": "<string>",
"hideBranding": true,
"isOrganization": true,
"isPrivate": true,
"hideBookATeamMember": false,
"metadata": {
"key": "value"
},
"theme": "<string>",
"brandColor": "<string>",
"darkBrandColor": "<string>",
"bannerUrl": "<string>",
"timeFormat": 123,
"timeZone": "Europe/London",
"weekStart": "Sunday"
}
}