public
apps

Mint a one-use grant to reveal a secret

Step one of two. Needs apps:secrets, which does not imply apps:read — mint both if the client also lists items. The grant is single-use, short-lived, and bound to the key that minted it — another key or a browser session cannot consume it, and a revoked key is refused even if it already holds a grant token. A recovery-critical value cannot be revealed with a key at all; the dashboard is the only path, because acknowledging that you saved it is something only a person can do.

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

Request

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

Path parameters

idstring required

instance id (uuid)

itemstring required

secret item identifier

Request body

acknowledge_unrecoverableboolean

AcknowledgeUnrecoverable is §22.3's explicit acknowledgement that Vozora cannot recover a recovery-critical secret after erasure. It is REQUIRED for that class and ignored for others.

Response

Created

acknowledgement_recordedboolean
classificationstring
expires_atstring
grantstring
itemstring
revisioninteger
service_idstring

Changes

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