Platform / Managed Users
Delete a managed user
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
Platform / Managed Users
Delete a managed user
DELETE
/
v2
/
oauth-clients
/
{clientId}
/
users
/
{userId}
curl --request DELETE \
--url https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId} \
--header 'x-cal-secret-key: <x-cal-secret-key>'
{
"status": "success",
"data": {
"id": 1,
"email": "[email protected]",
"username": "alice",
"name": "alice",
"bio": "bio",
"timeZone": "America/New_York",
"weekStart": "Sunday",
"createdDate": "2024-04-01T00:00:00.000Z",
"timeFormat": 12,
"defaultScheduleId": null,
"locale": "en",
"avatarUrl": "https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png",
"metadata": {
"key": "value"
}
}
}
Headers
OAuth client secret key
Response
200 - application/json
Available options:
success
, error
Example:
"success"
Example:
1
Example:
Example:
"alice"
Example:
"alice"
Example:
"bio"
Example:
"America/New_York"
Example:
"Sunday"
Example:
"2024-04-01T00:00:00.000Z"
Example:
12
Example:
null
Available options:
ar
, ca
, de
, es
, eu
, he
, id
, ja
, lv
, pl
, ro
, sr
, th
, vi
, az
, cs
, el
, es-419
, fi
, hr
, it
, km
, nl
, pt
, ru
, sv
, tr
, zh-CN
, bg
, da
, en
, et
, fr
, hu
, iw
, ko
, no
, pt-BR
, sk
, ta
, uk
, zh-TW
Example:
"en"
URL of the user's avatar image
Example:
"https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png"
Example:
{ "key": "value" }
Was this page helpful?
curl --request DELETE \
--url https://api.cal.com/v2/oauth-clients/{clientId}/users/{userId} \
--header 'x-cal-secret-key: <x-cal-secret-key>'
{
"status": "success",
"data": {
"id": 1,
"email": "[email protected]",
"username": "alice",
"name": "alice",
"bio": "bio",
"timeZone": "America/New_York",
"weekStart": "Sunday",
"createdDate": "2024-04-01T00:00:00.000Z",
"timeFormat": 12,
"defaultScheduleId": null,
"locale": "en",
"avatarUrl": "https://cal.com/api/avatar/2b735186-b01b-46d3-87da-019b8f61776b.png",
"metadata": {
"key": "value"
}
}
}