You are viewing the Apigee Management API reference documentation. For the main product docs, and to search all docs, go to

Create Environment

Resource Summary


Content Type

application/json, application/xml





Create Environment

Edge on-premises installation only. For an Edge cloud installation, contact Apigee Customer Support.

Creates an environment in an existing organization. 

Note: The characters you can use in the name attribute are restricted to: a-zA-Z0-9._\-$ %. 

After you create the environment, you must:

Edge provides scripts and other tools that you can use as an alternative to making API calls directly. For example, see


Resource URL /organizations/{org_name}/environments

Request Body

Name Description Default Required?
name The name of the environment. Characters you can use in the name are restricted to: a-zA-Z0-9._\-$ %. N/A Yes
description Environment description.. N/A No
properties Name/value pairs that may be used for customizing the environment. N/A No

org_name Mention the organization name true

HTTP Basic

OAuth 2.0



Make a request and see the response.

Make a request and see the response.

Make a request and see the response.


Help or comments?

  • If something's not working: Ask the Apigee Community or see Apigee Support.
  • If something's wrong with the docs: Click the "Send Feedback" button.
    (Incorrect? Unclear? Broken link? Typo?)