Write a new version of a secret
Seals the value at that address and appends a version.
/api/v1/secrets/{address}Seals the value at that address and appends a version. Nothing is overwritten, so an earlier version stays readable for recovery and rotation.
Authorization
bearer A machine credential, sent as Authorization: Bearer pck_.... Issue one from the console, or get a short-lived one from an exchange under auth.
In: header
Path Parameters
The parameter address. The last segment is the name and everything before it is the path, so slashes are part of the address and are not escaped. A parameter at the root is just its name.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The new value. Only a string is accepted; there is no typed write.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/api/v1/secrets/db/primary/DATABASE_URL" \ -H "Content-Type: application/json" \ -d '{ "value": "string" }'{ "version": -9007199254740991}