v1

latestOpenAPI 3.0.02026-07-17121287546.7 KB
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

Headers

Authorizationstring required

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

Request body

apiKeyDaysValidnumber

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

apiKeyNeverExpiresboolean

If true, organization api key never expires.

Example request

{
  "apiKeyDaysValid": 60,
  "apiKeyNeverExpires": true
}

Response

status'success' | 'error' required

Example response

{
  "status": "success"
}