Skip to main content

​
Update Secret Metadata

PATCH /v1/secrets/:id
Updates the expiry metadata on an existing secret. Use this to set or clear expires_at and strict_expiry_enforcement without changing the encrypted value.

​
Path Parameters

ParameterTypeDescription
iduuidThe secret ID

​
Request Body

At least one field is required.
FieldTypeDescription
expires_atstring | nullISO-8601 datetime for expiry, or null to clear
strict_expiry_enforcementbooleantrue to block injection when expired; false for warn-only

​
Response

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "STRIPE_API_KEY",
    "expires_at": "2027-01-15T00:00:00.000Z",
    "strict_expiry_enforcement": true
  },
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}

​
Errors

StatusTypeDescription
400validation_errorNo fields provided, invalid expires_at, or non-boolean strict_expiry_enforcement
404not_foundSecret not found