Skip to main content

​
Update Secret Value

Replaces the encrypted value of an existing string secret. You can target a specific environment to set an environment-specific override.

​
Path Parameters

​
Query Parameters

​
Request Body

​
Response

value_version is the environment’s version after this write — 1 when this call stored the environment’s first value, otherwise the previous version plus one. Because it is the version this call produced, storing it has no read-after-write race with a rotation happening concurrently. Compare it later with environments[].value_version from GET /v1/secrets/:id to detect a rotation performed outside your tooling. The value write and the version increment commit in one transaction, so a rotation is never recorded without its counter and a counter is never incremented without a rotation.

​
Errors