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

Update multiple service environment variables

Updates multiple environment variables associated with a service in one request. Provide the updates in the required data array, with each item containing the environment variable fields you want to change. A successful response returns the updated environment variable objects.

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

1 parameter · 1 body field
uuidstringrequired
The UUID of the service whose environment variables you want to update.

Bulk environment variable updates for a service.

dataarray<object>required
Array of environment variable update objects. Each item can include `key`, `value`, `is_literal`, `is_multiline`, `is_preview`, and `is_shown_once`.

5 status codes
201Returns an array of the updated environment variable objects.
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; data is required.