# Reveal a secret's value

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

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

**Console**
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.

**CLI**
```sh
dcloud secrets secrets get-value 5b8c1d2e-3f4a-4b6c-8d7e-9f0a1b2c3d4e
```

**API**
```http
GET /secrets/api/secrets/5b8c1d2e-3f4a-4b6c-8d7e-9f0a1b2c3d4e/value
```

## 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.

## Related

- [See who has read a secret](see-who-has-read-a-secret.md)
- `secrets.secrets.get-value` · `dcloud secrets secrets get-value`
