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

Refresh API Key

cURL

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
}
'

200

{
  "status": "success",
  "data": {
    "apiKey": "<string>"
  }
}

Headers

Authorization · string · required

value must be Bearer <token> where <token> is api key prefixed with cal_

Body

application/json

apiKeyDaysValid · number · default: 30

For how many days is managed organization api key valid. Defaults to 30 days.

Required range: x >= 1

Example:

60

apiKeyNeverExpires · boolean

If true, organization api key never expires.

Example:

true

Response

200 - application/json

status · enum<string> · required

Available options: success, error

Example:

"success"

data · object · required

Show child attributes