Skip to main content
POST
/
api
/
hooks
/
rotate-key
Rotate hook key
curl --request POST \
  --url https://api.crustocean.chat/api/hooks/rotate-key \
  --header 'Authorization: Bearer <token>'
{
  "key": "<string>"
}
Generates a new hook key and immediately invalidates the old one. Only the hook’s original author can call this endpoint.
The old key stops working as soon as rotation completes. Update the CRUSTOCEAN_HOOK_KEY environment variable in your backend immediately after rotating.

Authorizations

​
Authorization
string
header
required

Personal access token (cru_...) or session token from login/register.

Response

200 - application/json

New key returned

​
key
string