Send Docs Feedback

Note: Most user interface tasks can be performed in Edge Classic or the New Edge experience. For an overview, getting started topics, and release notes specific to the New Edge experience, see the docs.

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. See the Edge Operations Guide for more information on these tools. For example, for Edge 4.16.05 and later, 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?