Skip to content

Rotate the tenant's secret — the old one dies immediately

POST
/admin/tenants/{id}/rotate-secret
curl --request POST \
--url http://localhost:3000/admin/tenants/example/rotate-secret \
--header 'X-Admin-Key: <X-Admin-Key>'

A flag day, deliberately: no kid, no keyset, no multi-key verification. The Redis tenant cache key is deleted inside this operation — without that, “the old secret dies immediately” would be false by up to 60s (spec §5).

id
required
string

The new secret. Returned once.

Media typeapplication/json
object
api_secret
string
Examplegenerated
{
"api_secret": "example"
}