`GET /keys/apiKey`

Rotate your subscription key. Returns a new primary key and keeps the previous one valid as a secondary for 24 hours.

⚠️

Calling this endpoint immediately rotates your key. Make sure your deployment is ready to pick up the new key before calling.

Request

GET https://api.adzen.ai/keys/apiKey

curl https://api.adzen.ai/keys/apiKey \
  -H 'X-API-Key: YOUR_CURRENT_KEY'

{
  "apiKey": "prod-abcdef123456789",
  "secondaryKey": "prod-previous-key-value",
  "secondaryKeyExpiresAt": "2026-04-18T22:00:00Z"
}

Field	Type	Description
`apiKey`	string	The new primary key. Use this for all future requests.
`secondaryKey`	string	The previous primary key. Still valid for 24 hours.
`secondaryKeyExpiresAt`	string	ISO-8601 timestamp when the secondary key stops working.

Call GET /keys/apiKey
Store the new apiKey in your secrets manager
Deploy the new key to your application
Old requests using secondaryKey continue to succeed until secondaryKeyExpiresAt
After the expiry, only the new apiKey works

Status	Meaning
`401`	Current key invalid
`502`	Key rotation infrastructure unavailable — try again later