Update a secret

Secret updated (the value is never returned)

PUT /api/v1/secrets/{name}

cURL

curl --request PUT \
  --url 'https://api.sandbox.stateset.app/api/v1/secrets/{name}' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "value": "49.00",
  "scope": "sandbox",
  "allowed_sandbox_patterns": [
    "string"
  ],
  "expires_in_days": 1
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "scope": "string",
  "allowed_sandbox_patterns": [
    "string"
  ],
  "expires_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}

Path parameters

name · string · required

Secret name

Request body

UpdateSecretRequest

value · string

scope · string

allowed_sandbox_patterns · string[]

expires_in_days · integer

Response

object

id · string (uuid) · required

name · string · required

scope · string · required

allowed_sandbox_patterns · string[] · required

expires_at · string (date-time) · required

updated_at · string (date-time) · required

Status codes

Code	Meaning
200	Secret updated (the value is never returned)
404	Secret not found

cURL

curl --request PUT \
  --url 'https://api.sandbox.stateset.app/api/v1/secrets/{name}' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "value": "49.00",
  "scope": "sandbox",
  "allowed_sandbox_patterns": [
    "string"
  ],
  "expires_in_days": 1
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "scope": "string",
  "allowed_sandbox_patterns": [
    "string"
  ],
  "expires_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}