When updating properties, you must pass all existing properties to the API, even if they are not being changed. If you omit properties from the payload, the properties are removed. To get the current list of properties for the environment, use theGet Environment API.
Note: BothPUTandPOSTmethods are supported for updating an existing environment.
HTTP request
PUT https://apigee.googleapis.com/v1/{name=organizations/*/environments/*}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Method: organizations.environments.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates an existing environment.\n\nWhen updating properties, you must pass all existing properties to the API, even if they are not being changed. If you omit properties from the payload, the properties are removed. To get the current list of properties for the environment, use the [Get Environment API](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments/get).\n\n**Note** : Both `PUT` and `POST` methods are supported for updating an existing environment.\n\n### HTTP request\n\n`PUT https://apigee.googleapis.com/v1/{name=organizations/*/environments/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains an instance of [Environment](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments#Environment).\n\n### Response body\n\nIf successful, the response body contains an instance of [Environment](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments#Environment).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`"]]
