public
apps

Reveal a secret value once

Step two of two. Atomically consumes the grant and returns exactly one value; the grant is burned whether or not the reveal succeeds. The calling key and the bound revision are re-read and compared at consume time, so a different key, a rotation, a reinstall supersession or a termination invalidates an outstanding grant. A REVOKED key is refused earlier still, by the credential check every request passes through. Every reveal is audited with the key's id. The response is Cache-Control no-store, private.

post/v1/instances/{id}/app/secrets/{item}/reveal

Request

  • Base URL: https://api.vozora.io
  • URL: https://api.vozora.io/v1/instances/{id}/app/secrets/{item}/reveal
  • Auth: API key in header Authorization

Path parameters

idstring required

instance id (uuid)

itemstring required

secret item identifier

Request body

grantstring

Response

OK

classificationstring
itemstring
purposestring
revealed_atstring
revisioninteger
save_acknowledgement_challengestring
save_acknowledgement_expires_atstring
service_idstring
valuestring

Changes

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