Auth

Create a staged replacement private API key

Requires a stable Idempotency-Key. The current key remains active until explicit revocation. The replacement raw value is hash-only and returned once; exact retry identifies the prior replacement and confirms whether the old key remains active without minting again.

post/v1/auth/keys/rotate

Request

  • Base URL: https://api.agentry.sh
  • URL: https://api.agentry.sh/v1/auth/keys/rotate
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Stable 8-500 character command key. Preserve it only when replaying the exact same request; use a new key for a distinct command.

Response

OK

api_keystring required
key_idstring required
prefixstring required
user_idstring required
previous_key_idstring required
previous_key_activeboolean required
idempotent_replayboolean required
next_actionstring required

Changes

No recorded changes to this operation across all 1 revision of this API.