---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Access a secret version"
description: "`secrets.secret_versions.access` (POST /v1/{name}:access): Reads a secret version's value back."
type: reference
product: platform
summary: "Reads a secret version's value back."
updated: 2026-09-28
nav: false
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

Reads a secret version's value back. Break-glass: a separate permission, audited on every call, and never exposed to MCP.

- **Path** `POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version:access`
- **Scope** `secrets:access`
- **Effect** `read` — nothing is written.
- **Collection** [secret_versions](/docs/api/secret_versions)

## Request

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | The name of the secret version to read. Required. |

## Response

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | The secret version read. |
| `payload` | `bytes` | The value. Never returned again. |

## Errors

- [`UNAUTHENTICATED`](/docs/api/errors/UNAUTHENTICATED) — No valid key or token was presented.
- [`PERMISSION_DENIED`](/docs/api/errors/PERMISSION_DENIED) — The key lacks the method's permission.
- [`RESOURCE_NOT_FOUND`](/docs/api/errors/RESOURCE_NOT_FOUND) — The named Resource does not exist or is not visible.
- [`INVALID_STATE`](/docs/api/errors/INVALID_STATE) — The Resource is in a state that forbids the call.

Every error arrives in the body [Errors](/docs/platform/errors) describes.

## Examples

**cURL**

```curl
curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version:access" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

**TypeScript**

```ts
const response = await sylphx.secrets.secretVersions.access({ name: 'orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version' })
```

**Rust**

```rust
let mut req = sylphx::secrets::AccessSecretVersionRequest::default();
req.name = "orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version".to_string();
let response = sx.secrets().secret_versions().access(req).await?;
```

**CLI**

```bash
sylphx secrets secret-versions access orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version
```

**MCP**

```json
{ "method_id": "secrets.secret_versions.access", "args": {"name":"orgs/acme/projects/shop/envs/production/secrets/secret/secret_versions/secret-version"} }
```