---
title: "Update an environment"
method: PATCH
path: "/environments/{environment_id}"
tags: ["Environments"]
---

# Update an environment

`PATCH /environments/{environment_id}`

Update an environment's name, default flag, and variable values. The supplied `values` replace the existing values in full — they are not merged. Marking an environment as the default automatically unsets the previous default environment.

## Path parameters

- `environment_id` string, uuid4, required

## Request body

- PatchEnvironmentsRequest — Request to update an environment.
  - `name` string, required
  - `values` object, required
  - `defaultEnv` boolean, required

## Response `200`

Successful Response

- EnvironmentsResponse — Details of an Orchestra environment with its variable values.
  - `accountId` string, uuid4, required
  - `environmentId` string, uuid4, required
  - `name` string, required
  - `defaultEnv` boolean, required
  - `values` object, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) · [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getorchestra/orchestra-api/revisions/50f4d2ba114d/schema)