---
title: "Write secret values through the tenant's selected provider"
method: PUT
path: "/tenants/{tenantId}/secrets/values"
tags: ["SecretProviders"]
---

# Write secret values through the tenant's selected provider

`PUT /tenants/{tenantId}/secrets/values`

Writes one or more secret values through the tenant's selected writable secret provider and returns the canonical reference for each key. Values are write-only; only the resulting references are returned so they can be stored in configuration. The selected provider must be writable - a read-only provider (such as the environment floor or a Kubernetes secret mount) is rejected.

## Parameters

- `./platform-config-components.yml#/components/parameters/TenantId` — unresolved $ref

## Request body

- SecretValuesWriteRequest — unresolved $ref

## Response `200`

Canonical references for the written values.

- SecretValuesWriteResult — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref

## Changes

- **2026-06-17** `f39de1a395fb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sphereon-opensource/apis/platform-config-api/changes/tenants/:tenantId/secrets/values/put.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/platform-config-api.md) · [All operations](https://skmtc.dev/sphereon-opensource/apis/platform-config-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sphereon-opensource/platform-config-api/revisions/f0066c61ebdb/schema)