Skip to main content

Save Service Config

PUT 
/api/v1/services/:service/:instance

Create or update a service config.

Each top-level section in the body replaces the stored one, and a section the body leaves out is kept as stored, so a form that sends some sections cannot drop the rest and the secrets in them. A section written as null is removed.

A read shows every set secret masked, so a masked value written back keeps the secret stored there, matched as the app surface matches one. A mask with nothing stored behind it, or in a list entry that cannot be told apart, is a 400 masked_value and nothing is saved. A changed field beside a masked secret, in the same mapping or with the secret one mapping down, is a 400 credential_reentry_required: the secret is typed again. A value the app's contract refuses is a 422 invalid_config.

Request​

Responses​

Successful Response