POST /api-keys/:id/rotate

Generates a new secret for an existing API key. The previous key value is immediately invalidated.

Base URL: https://api.geocerta.io

Sandbox URL: https://api-staging.geocerta.io

Authentication required. Include your API key in the api-key header. See Authentication.

Endpoint

POST /api-keys/:id/rotate

Parameter	Description
`id`	The `_id` of the API key to rotate

200 OK — returns the new key value. Store it securely — it will not be shown again.

Status	Message	Cause
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	The key does not belong to your account
`404`	API key not found	No key exists with the given `id`

curl -X POST "https://api.geocerta.io/api-keys/66f3a1b2c4e5d8f9a1b2c4e5/rotate" \
  -H "api-key: YOUR_API_KEY"