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

Create an application environment variable

Creates an environment variable for an application identified by its UUID. Provide the variable's key and value, and set optional flags to control literal, multiline, preview, or display behavior. 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 to add the environment variable to.

Environment variable properties, including its key and value and optional configuration flags.

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.
keystringoptional
The key of the environment variable.
valuestringoptional
The value of the environment variable.

4 status codes
201Returns an object containing the UUID of the created environment variable.
uuidstringoptional
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; provide the environment variable properties to create, such as key and value.