Skip to main content
GET/vault/secrets/{path}

Reveal Secret

Returns a secret's value, base64.

Send a challenge from Request Reveal Challenge in the X-K9O-Reveal-Challenge header: each challenge works once, within 60 seconds.

With op=versions, returns the secret's version history instead, with no value, and needs no challenge.

The secret's owner and the callers it is shared with can reveal it.

Parameters
projectId *query

The project's id.

path *path

The secret's path: /-delimited segments, such as database/prod/password.

Responses
HTTPK9O CodeDescription
200Without `op`: the value. With `op=versions`: the version history.
401`K9O_REVEAL_CHALLENGE_REQUIRED`: no reveal challenge, or one kibo doesn't recognise. `K9O_REVEAL_CHALLENGE_EXPIRED`: the challenge is more than 60 seconds old.
404No such secret visible to the caller.
409`K9O_REVEAL_CHALLENGE_CONSUMED`: the challenge was already used. Request a new one.
Response body (200)
One of: object
attestationTier *object

The hardware trust the kibo node declares for this operation.

operator *string

Who runs the node: platform for a platform-run node, client for one the customer runs.

The platform sets it, never the workload.

Example: "platform"
urn *string

The trust tier, as attestation:destination:region, such as sev-snp:azure:us-east.

Example: "sev-snp:azure:westeurope"
verified *boolean

Whether the node's own attestation verified against the vendor PKI on the URN's attestation segment. false for the standard-hardened fallback (declared honestly, not masqueraded as a CVM).

Example: true
id *string

sec_<base62>.

Example: "sec_4fK9xQ2mZ7aB"
name *string

Path-name at reveal time.

Example: "database/prod/password"
revealedAt *string <date-time>

Reveal timestamp.

Example: "2026-11-15T09:30:00.123Z"
value *string

Plaintext bytes, base64-encoded (TLS-only transport).

Example: "czNjcjN0LXBhc3N3MHJk"
version *integer <int64>

Revealed version.

Example: 3
or: object
activeVersion *integer <int64>

The active version.

Example: 3
id *string

sec_<base62>.

Example: "sec_4fK9xQ2mZ7"
name *string

The secret's path.

Example: "database/prod/password"
versions *object[]

The version history, newest first.

createdAt *string <date-time>

When this version was written.

Example: "2026-11-14T16:05:12.004Z"
version *integer <int64>

The version number.

Example: 3
TypeScript
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data: challenge } = await k9o.kibo.vault.secrets.revealChallenge('<name>')
const { data } = await k9o.kibo.vault.secrets.reveal('<name>', { challenge: challenge.challenge })

Showing example in TypeScript

Response example (200)
{
  "attestationTier": {
    "operator": "platform",
    "urn": "sev-snp:azure:westeurope",
    "verified": true
  },
  "id": "sec_4fK9xQ2mZ7aB",
  "name": "database/prod/password",
  "revealedAt": "2026-11-15T09:30:00.123Z",
  "value": "czNjcjN0LXBhc3N3MHJk",
  "version": 3
}

More in Secrets