Update Environment

PUT {{apiPath}}/environments/{{envID}}

To update the configuration of your environment, you can use PUT /environments/{{envID}} to modify the attributes of the specified environment. The sample shows an update to the name and description attributes.

Note: The environment's region attribute cannot be modified in a PUT request. The region attribute value is defined when the environment resource is created (POST request) and cannot be changed.

Prerequisites

For property descriptions, see Environments data model.

PropertyTypeRequired?
billOfMaterialsObjectOptional
billOfMaterials.products[0]ArrayOptional
billOfMaterials.products[0].idStringRequired
billOfMaterials.products[0].typeStringOptional
billOfMaterials.products[0].descriptionStringOptional
billOfMaterials.products[0].consoleStringOptional
billOfMaterials.products[0].softwareLicense.idStringOptional
billOfMaterials.products[0].deployment.idStringOptional
descriptionStringOptional
iconStringOptional
license.idStringRequired
nameStringRequired
organization.idStringOptional
typeStringRequired

Request Body

{"name"=>"Updated-Environment-Name", "region"=>"NA", "type"=>"SANDBOX", "description"=>"Updated Description", "billOfMaterials"=>{"products"=>[{"type"=>"PING_ONE_BASE", "description"=>"New environment product description", "console"=>{"href"=>"https://example.com"}}]}}