---
title: "PATCH /applications/{ApplicationId}/environments/{EnvironmentId}"
method: PATCH
path: "/applications/{ApplicationId}/environments/{EnvironmentId}"
---

# PATCH /applications/{ApplicationId}/environments/{EnvironmentId}

`PATCH /applications/{ApplicationId}/environments/{EnvironmentId}`

Updates an environment.

## Path parameters

- `ApplicationId` string, required
- `EnvironmentId` string, required

## Request body

- object
  - `Name` string — The name of the environment.
  - `Description` string — A description of the environment.
  - `Monitors` Monitor[] — Amazon CloudWatch alarms to monitor during the deployment process.
    - `AlarmArn` string, required — Amazon Resource Name (ARN) of the Amazon CloudWatch alarm.
    - `AlarmRoleArn` string — ARN of an Identity and Access Management (IAM) role for AppConfig to monitor <code>AlarmArn</code>.

## Response `200`

Success

- Environment
  - `ApplicationId` string — The application ID.
  - `Id` string — The environment ID.
  - `Name` string — The name of the environment.
  - `Description` string — The description of the environment.
  - `State` 'READY_FOR_DEPLOYMENT' | 'DEPLOYING' | 'ROLLING_BACK' | 'ROLLED_BACK' — The state of the environment. An environment can be in one of the following states: <code>READY_FOR_DEPLOYMENT</code>, <code>DEPLOYING</code>, <code>ROLLING_BACK</code>, or <code>ROLLED_BACK</code>
  - `Monitors` Monitor[] — Amazon CloudWatch alarms monitored during the deployment.
    - `AlarmArn` string, required — Amazon Resource Name (ARN) of the Amazon CloudWatch alarm.
    - `AlarmRoleArn` string — ARN of an Identity and Access Management (IAM) role for AppConfig to monitor <code>AlarmArn</code>.

## Other responses

- `480` — BadRequestException
- `481` — ResourceNotFoundException
- `482` — InternalServerException

---

[API](https://skmtc.net/aws/apis/appconfig.md) · [All operations](https://skmtc.net/aws/apis/appconfig/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/appconfig/versions/924584438718/schema)