rootKeys
Reroll root key
Changed onCreates a new root key secret with the same name, enabled state, expiration, and effective permissions as an existing root key in the authenticated workspace. Requires unkey:v1:<workspace_id>:rootKeys/<key_id>#write, and the caller must already hold every permission of the original key. When expiration is not null, it also requires unkey:v1:<workspace_id>:rootKeys/<key_id>#delete.
expiration controls the original key: 0 revokes it immediately, a positive value keeps it valid for that many milliseconds, and null keeps its current expiration.
post/v2/rootKeys.rerollKey
Request
- Base URLhttps://api.unkey.com
- URLhttps://api.unkey.com/v2/rootKeys.rerollKey
- AuthHTTP bearer
Request body
Response
Root key rerolled. Save the secret now; it cannot be retrieved later.
Example response
{
"meta": {
"requestId": "req_123"
}
}Changes
- info
endpoint added
- info