Skip to the page

Reveal one secret value (audited)

POST/v1/organisations/{id}/environments/{envId}/resources/{rid}/secrets/{name}/reveal

Operation secrets.reveal · since 2026-11-05 · stable

Needs a session withwritescopeAnswers200 OKanswers a secret

The value. Never cached; every reveal is recorded in activity.

This answer holds a secret

It is sent with cache-control: no-store and every call is recorded in the organisation's activity. Do not log it.

Path parameters

idstring (uuid)required
The organisation id.
envIdstring (uuid)required
The environment id.
ridstringrequired
The secret group's id.
namestringrequired
The secret, like STRIPE_KEY.

Body

None. Send no body, or an empty JSON object.

Errors

Every error is { "error", "message", "detail"? } (Errors and references). Besides the codes any route can answer.

POST/v1/organisations/{id}/environments/{envId}/resources/{rid}/secrets/{name}/reveal
curl -X POST "https://api.rykloud.com/v1/organisations/$ORG_ID/environments/$ENV_ID/resources/$RESOURCE_ID/secrets/$NAME/reveal" \
  -H "Authorization: Bearer $RYKLOUD_TOKEN"
With the rykloud CLI
rykloud secrets reveal GROUP NAME

Command reference: rykloud secrets reveal