CustomDomain™ docs
API referenceTenancy

Rotate the workspace default key (new secret returned once)

POST
/tenants/{tenant_id}/default-key:rotate

Mints a new default key and revokes the old active one in one transaction: the old key stops authenticating at once, and there is never a moment with two active default keys or none. The workspace's other keys are untouched. With no active default key it simply creates one. Same provision secret guard as POST /tenants/{tenant_id}/default-key.

Authorization

provisionSecret
X-Provision-Secret<token>

Narrow secret for the one-call signup provisioning endpoint (also accepted as a Bearer token).

In: header

Path Parameters

tenant_id*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tenants/string/default-key:rotate"
{  "key_id": "string",  "prefix": "string",  "created": true,  "api_key": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}