Api Keys
Refresh API Key
Getting Started
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
- GETGet all attribute options
- POSTCreate an attribute option
- DELDelete an attribute option
- PATCHUpdate an attribute option
- GETGet by attribute id all of the attribute options that are assigned to users
- GETGet by attribute slug all of the attribute options that are assigned to users
- GETGet all attribute options for a user
- POSTAssign an attribute to a user
- DELUnassign an attribute from a user
Orgs / Bookings
Orgs / Delegation Credentials
Orgs / Memberships
Orgs / Routing forms
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Conferencing
- POSTConnect your conferencing application to a team
- GETGet OAuth conferencing app's auth url for a team
- GETList team conferencing applications
- POSTSet team default conferencing application
- GETGet team default conferencing application
- DELDisconnect team conferencing application
- GETSave conferencing app OAuth credentials
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
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
Managed Orgs
OAuth Clients
Organizations/Teams Stripe
Routing forms
Schedules
Selected Calendars
Slots
Teams / Event Types
Teams / Memberships
Api Keys
Refresh API Key
Generate a new API key and delete the current one. Provide API key to refresh as a Bearer token in the Authorization header (e.g. "Authorization: Bearer <apiKey>").
POST
/
v2
/
api-keys
/
refresh
curl --request POST \
--url https://api.cal.com/v2/api-keys/refresh \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"apiKeyDaysValid": 60,
"apiKeyNeverExpires": true
}'
{
"status": "success",
"data": {
"apiKey": "<string>"
}
}
Headers
value must be Bearer <token>
where <token>
is api key prefixed with cal_
Body
application/json
For how many days is managed organization api key valid. Defaults to 30 days.
Required range:
x >= 1
Example:
60
If true, organization api key never expires.
Example:
true
Was this page helpful?
curl --request POST \
--url https://api.cal.com/v2/api-keys/refresh \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"apiKeyDaysValid": 60,
"apiKeyNeverExpires": true
}'
{
"status": "success",
"data": {
"apiKey": "<string>"
}
}