Reveal a secret's value

Read the decrypted active value of a secret, recorded in its access log.

Last updated 18 November 2026View as Markdown

Replace 5b8c1d2e-3f4a-4b6c-8d7e-9f0a1b2c3d4e with the secret's id. The console shows it in the secret's panel under Details, as ID.

Prerequisites

  • Permission for secrets:GetSecretValue on the secret. It is a sensitive action: the generated read-only policies leave it out, and a refused attempt is recorded in the audit log. In the console, also secrets:ListSecrets to open Secrets; without it the page says "You do not have permission to list secrets."
  • The secret's key enabled.

Reveal the value

  1. Open Secrets and choose the secret. Its panel opens.
  2. Under Value (for a synced secret, Last synced value), choose Reveal value.

The value arrives masked, with a button to show it and one to copy it. Closing the panel forgets it. Without the permission, the button explains which action is missing.

Result

200 with { id, name, value, version }: the active version's value. The read is written to the secret's access log with the version and how you read it (console session, access key or connected app).

Refusals

  • 403 without secrets:GetSecretValue on the secret.
  • 409 "Encryption key is unavailable", when the key is disabled, scheduled for deletion or has no material. In the console, Reveal value says why instead.
  • 404 "Not found" for an id that is not a secret of your organization.
Did this page help you?