Skip to main content
POST
Rotate a secret.

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Path Parameters

secretId
string
required

Secret metadata identifier.

Body

application/json
secret
string
required

New secret value. Creates an immediately active revision and disables all previous active revisions of this secret atomically. Previous revisions remain in history; the total revision quota still applies.

Minimum string length: 1

Response

New revision metadata without secret material.

secretDataId
string<uuid>
required
secretId
string<uuid>
required
active
boolean
required
actDate
string<date-time>
required
version
number
required
createdBy
string<uuid>
required
createdAt
string<date-time>
required
lastUpdateBy
string<uuid>
required
lastUpdateAt
string<date-time>
required
deletedAt
string<date-time> | null
deletedBy
string<uuid> | null
Last modified on October 1, 2026