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

Update a service environment variable

Updates an environment variable associated with a service. Provide key and value to identify the variable and set its value; use the flags to configure literal, multiline, preview, or shown-once behavior.

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

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

Environment variable details to update. key and value 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.

5 status codes
201Returns the updated environment variable object, including its key and configuration flags.
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 service resource is not found.
messagestringoptional
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 indicates an invalid token, and a 401 indicates an unauthenticated request. A 404 indicates the service resource was not found; the uuid path parameter must identify an existing service. A 422 indicates validation errors; key and value are required.