---
title: "Update Environment"
method: PATCH
path: "/projects/{uuid}/environments/{environment_name_or_uuid}"
tags: ["Projects"]
---

# Update Environment

`PATCH /projects/{uuid}/environments/{environment_name_or_uuid}`

Update environment by name or UUID within a project.

## Path parameters

- `uuid` string, required
- `environment_name_or_uuid` string, required

## Request body

- object
  - `name` string — The name of the environment.
  - `description` string — The description of the environment.

## Response `200`

Environment updated.

- object
  - `uuid` string
  - `name` string
  - `description` string

## Other responses

- `400` — Invalid token.
- `401` — Unauthenticated.
- `404` — Project or environment not found.
- `409` — Environment with this name already exists.
- `422` — Validation error.

## Changes

- **2026-07-22** `71a39cd460a7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/projects/:uuid/environments/:environment_name_or_uuid/patch.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coollabsio/coolify/revisions/789e6ad3796c/schema)