Secrets

Rotate secret

Replace the token for the same server_url with compare-and-set on row_version. Idempotency-Key is required. Only new Sessions use the new token.

post/v1/secrets/{secret_id}/rotate

Request

  • Base URL: https://api.sandbase.ai
  • URL: https://api.sandbase.ai/v1/secrets/{secret_id}/rotate
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring required

Required. 1-128 characters without leading or trailing whitespace. Reuse the same key and body when retrying.

Request body

tokenstring required
row_versioninteger required

Response

Secret

idstring required

Secret ID (sec_ prefix).

namestring required
kind'mcp_bearer' required
server_urlstring required
status'pending' | 'active' | 'disabled' required

disabled means revoked.

row_versioninteger required
created_atstring date-time required
updated_atstring date-time required

Changes

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