Secrets

Write a secret version

Creates a new encrypted version. Admitted sandboxes retain their pinned versions. Retired ciphertext is destroyed after seven days only when no nonterminal sandbox or connection retains it.

post/v1/secrets

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Request body

namestring required
valuestring required

Nonempty UTF-8 secret with at most 4096 encoded bytes and no NUL characters.

Response

Success

namestring required
versioninteger required
created_atstring date-time required
idstring required

Stable tenant secret ID shared by its versions.

Changes

No recorded changes to this operation across all 70 revisions of this API.