Update a secret
Update an existing secret’s value or metadata
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Secret ID or name
Body
Updated secret configuration
Description is an optional human-readable description of the secret's purpose (max 500 characters)
500Name is the new unique identifier for the secret. Can contain alphanumeric characters, underscores, hyphens, forward slashes, and periods (1-100 characters)
1 - 100ProjectID is ignored - the project is automatically determined from your authentication
TTLSeconds sets a new lifetime and restarts the expiry from now, between 86400 (1 day) and 1209600 (14 days)
86400 <= x <= 1209600Value is the new sensitive data to store securely. Updating this replaces the existing secret value.
1Response
Secret updated successfully
CreatedAt is the ISO8601 timestamp when this secret was created
CreatedBy is the identifier of who created this secret.
Description is a human-readable description of the secret's purpose
ExpiresAt is the ISO8601 timestamp when this secret expires and is deleted. Changing the value extends it. Omitted for secrets that never expire
ID is the unique identifier for this secret
LastUpdatedBy is the identifier of who last updated this secret.
Name is the name/key of the secret
The object type, which is always secret.
TTLSeconds is the secret's lifetime in seconds. Omitted when no TTL is set
UpdatedAt is the ISO8601 timestamp when this secret was last updated