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:GetSecretValueon 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, alsosecrets:ListSecretsto open Secrets; without it the page says "You do not have permission to list secrets." - The secret's key enabled.
Reveal the value
- Open Secrets and choose the secret. Its panel opens.
- 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.
dcloud secrets secrets get-value 5b8c1d2e-3f4a-4b6c-8d7e-9f0a1b2c3d4eGET /secrets/api/secrets/5b8c1d2e-3f4a-4b6c-8d7e-9f0a1b2c3d4e/valueResult
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
403withoutsecrets:GetSecretValueon 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.
Related
Did this page help you?