---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Secret bindings"
description: "The `secret_bindings` collection of Sylphx Secrets: A SecretBinding delivers a Secret's value to one workload: as an environment variable, as a file, or by egress injection, where the platform adds the value to outgoing requests to…"
type: reference
product: platform
summary: "A SecretBinding delivers a Secret's value to one workload: as an environment variable, as a file, or by egress injection, where the platform…"
updated: 2026-09-28
order: 900
---

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

A SecretBinding delivers a Secret's value to one workload: as an environment variable, as a file, or by egress injection, where the platform adds the value to outgoing requests to allowlisted hosts and the workload never sees it. Releases pin bindings, never values.

**Service** Sylphx Secrets · **Resource type** `secrets.sylphx.com/SecretBinding` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/secret_bindings/{secret_binding}` · **Shape** `spec_status`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/secret_bindings/{secret_binding}`. |
| `uid` | `string` | `scb_<cell><ulid>`. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `SecretBindingSpec` | Desired state. Required. |
| `status` | `SecretBindingStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/secret_bindings#get) | Gets a secret binding. |
| `GET` | [`list`](/docs/api/secret_bindings#list) | Lists secret bindings in an environment. |
| `POST` | [`create`](/docs/api/secret_bindings#create) | Creates a secret binding. |
| `PATCH` | [`update`](/docs/api/secret_bindings#update) | Updates a secret binding. |
| `DELETE` | [`delete`](/docs/api/secret_bindings#delete) | Deletes a secret binding. |

## get

Gets a secret binding.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secret_bindings/secret-binding` · scope `secrets:read` · effect `read` · [Request, response and examples](/docs/api/secret_bindings/get)

## list

Lists secret bindings in an environment.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secret_bindings` · scope `secrets:read` · effect `read` · paginated · [Request, response and examples](/docs/api/secret_bindings/list)

## create

Creates a secret binding.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secret_bindings` · scope `secrets:write` · effect `write` · [Request, response and examples](/docs/api/secret_bindings/create)

## update

Updates a secret binding.

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secret_bindings/secret-binding` · scope `secrets:write` · effect `write` · [Request, response and examples](/docs/api/secret_bindings/update)

## delete

Deletes a secret binding.

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/secret_bindings/secret-binding` · scope `secrets:write` · effect `destructive` · [Request, response and examples](/docs/api/secret_bindings/delete)