---
title: "Updates an environment by name"
method: PUT
path: "/api/admin/environments/update/{name}"
tags: ["Environments"]
---

# Updates an environment by name

`PUT /api/admin/environments/update/{name}`

**Enterprise feature**

Given an environment by name updates the environment with the given payload. Note that `name`, `enabled` and `protected` cannot be changed by this API

## Path parameters

- `name` string, required

## Request body

- UpdateEnvironmentSchema — Data used to update an [environment](https://docs.getunleash.io/concepts/environments).
  - `type` string — Updates the type of environment (i.e. development or production).
  - `sortOrder` integer — Changes the sort order of this environment.
  - `requiredApprovals` integer, nullable — Experimental field. The number of approvals required before a change request can be applied in this environment.

## Response `200`

environmentSchema

- EnvironmentSchema — A definition of the project environment
  - `name` string, required — The name of the environment
  - `type` string, required — The [type of environment](https://docs.getunleash.io/concepts/environments#environment-types).
  - `enabled` boolean, required — `true` if the environment is enabled for the project, otherwise `false`.
  - `protected` boolean, required — `true` if the environment is protected, otherwise `false`. A *protected* environment can not be deleted.
  - `sortOrder` integer, required — Priority of the environment in a list of environments, the lower the value, the higher up in the list the environment will appear. Needs to be an integer
  - `projectCount` integer, nullable — The number of projects with this environment
  - `apiTokenCount` integer, nullable — The number of API tokens for the project environment
  - `enabledToggleCount` integer, nullable — The number of enabled toggles for the project environment
  - `requiredApprovals` integer, nullable — Experimental field. The number of approvals required before a change request can be applied in this environment.

## Other responses

- `400` — The request data does not match what we expect.
- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.

---

[API](https://skmtc.net/unleash/apis/unleash-api-3.md) · [All operations](https://skmtc.net/unleash/apis/unleash-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unleash/unleash-api-3/revisions/b2c3116e633e/schema)