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
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.