/vault/secrets/{path}?op=versionsList Secret Versions
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.
| projectId * | query | The project's id. |
| path * | path | The secret's path: |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Without `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. | |
| 404 | No such secret visible to the caller. | |
| 409 | `K9O_REVEAL_CHALLENGE_CONSUMED`: the challenge was already used. Request a new one. |
| One of: object | ||
| attestationTier * | object | The hardware trust the kibo node declares for this operation. |
| operator * | string | Who runs the node: The platform sets it, never the workload. Example: "platform" |
| urn * | string | The trust tier, as Example: "sev-snp:azure:westeurope" |
| verified * | boolean | Whether the node's own attestation Example: true |
| id * | string |
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 |
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 |
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/vault/secrets/<name>?op=versions' \
-H 'Authorization: Bearer $K9O_TOKEN'Showing example in cURL
{
"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
}