Coolify Octri Demo
PATCH/applications/{uuid}/envs

Update an application environment variable

Updates an environment variable for an application identified by its UUID. Supply key and value to identify the variable and provide its new value; use the optional flags to configure how the variable is handled. Set is_shown_once to hide the saved value in the UI and API responses.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 6 body fields
uuidstringrequired
The UUID of the application whose environment variable to update.

Environment variable values and optional configuration flags. The key and value fields are required.

is_literalbooleanoptional
The flag to indicate if the environment variable is a literal, nothing espaced.
is_multilinebooleanoptional
The flag to indicate if the environment variable is multiline.
is_previewbooleanoptional
The flag to indicate if the environment variable is used in preview deployments.
is_shown_oncebooleanoptional
If true, the saved value is hidden in the UI and API responses. MCP never returns environment variable values.
keystringrequired
The key of the environment variable.
valuestringrequired
The value of the environment variable.

4 status codes
201Returns the updated environment variable object, including its key, configuration flags, and other model fields.
commentstringoptional
created_atstringoptional
idintegeroptional
is_buildtimebooleanoptional
is_literalbooleanoptional
is_multilinebooleanoptional
is_previewbooleanoptional
is_runtimebooleanoptional
is_sharedbooleanoptional
is_shown_oncebooleanoptional
If true, the saved value is hidden in the UI and API responses. MCP never returns environment variable values.
keystringoptional
real_valuestringoptional
resourceable_idintegeroptional
resourceable_typestringoptional
updated_atstringoptional
uuidstringoptional
valuestringoptional
versionstringoptional
400Returned when the token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when the application resource is not found.
messagestringoptional

Error handling

A 400 is returned for an invalid token, a 401 when the request is unauthenticated, and a 404 when the resource is not found. The uuid path parameter must identify an existing application. The body requires key and value.