Skip to main content

Set App Config

PUT 
/api/v1/apps/:service/:instance/config

Write options the app declares, and environment keys it does not.

Judged against the app's own contract before anything is committed, so a value the app would refuse at startup leaves the deploy repo where it was rather than landing a commit an operator then has to revert.

A secret is written like any other option: it goes into the overlay as the rest of this surface writes one, and neither this response nor a read route on this surface says what it is. A masked value written back as it was read keeps the stored credential. The mask where nothing is stored is a 400 masked_value. A changed field beside a stored credential, in the same mapping or with the credential one mapping down (brokers beside sasl.password), is a 400 credential_reentry_required until that mapping is written whole with its credentials typed again. A setting inside another mapping beside it, such as producer.retries, is not. config and extraEnv are roots, so a setting directly under either never needs one.

409 where the deployment already decides the value: a config path the chart derives, or an extraEnv name the chart sets for this app.

Request​

Responses​

Successful Response