Generates a new HS256 secret for signed identity tokens from the customer's logged-in portal. Rotating invalidates the previous key immediately. The plaintext secret is returned exactly once and must be stored server-side by the customer — never in browser code. Tokens signed with it must have sub=customer number, aud=agent id, iat, and exp no more than 15 minutes after iat.
Request
Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************
or
Path Params
Responses
🟢200
application/json
New key. Shown once.
Bodyapplication/json
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request POST 'https://api.snakk.ai/api/agents//identity-key' \
--header'X-API-Key: <api-key>'