Update Project Shared Env

API server

https://app.coolify.io/api/v1

Choose where to send API requests

This changes the request URL and code examples on every endpoint page.

API server type

Requests will use

https://app.coolify.io/api/v1

Use only a Coolify URL you trust. Sending a test request also sends the API token you enter.

PATCH
/projects/{uuid}/envs/{env_id}

Update a project shared environment variable by id.

Authorization

bearerAuth
AuthorizationBearer <token>

Go to Keys & Tokens / API tokens and create a new token. Use the token as the bearer token.

In: header

Path Parameters

uuid*string

Project UUID

env_id*integer

Shared env id (integer).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

key?string
value?string|null
is_literal?boolean
is_multiline?boolean
is_shown_once?boolean

If true, the saved value is hidden in the UI and API responses. A lock is permanent: false does not unlock a locked variable, but a new value can still replace the locked one. MCP never returns environment variable values.

comment?|
Lengthlength <= 256

Response Body

application/json

application/json

application/json

curl -X PATCH "https://app.coolify.io/api/v1/projects/string/envs/0" \  -H "Content-Type: application/json" \  -d '{}'
Empty
{  "message": "Unauthenticated."}
{  "message": "Resource not found."}
{  "message": "Validation error.",  "errors": {    "name": [      "The name field is required."    ],    "api_url": [      "The api url field is required.",      "The api url format is invalid."    ]  }}