Skip to main content
PUT
Create or update a settings profile

Authorizations

x-api-key
string
header
required

Path Parameters

name
string
required

Body

application/json

The persisted body of a versioned settings profile.

env is the whole profile-managed env band (values verbatim, secrets included — the store rides the secret=True versioned-documents backup section); applying the profile REPLACES the stored env with it (a key the profile does not name is deleted, save the carried X-band). secret_keys are the per-profile secret marks (which env keys are secret) folded into the display mask union. description is the profile's human description.

description
string
default:""
env
Env · object
secret_keys
string[]

Response

Success.

data
ProfileWriteResult · object
required

A profile write/rollback confirmation — the new active version, never the body (so a secret never re-emits on the write path).