Send Docs Feedback

Making management API calls from this page

  1. In the URL, replace any values indicated by "{ }", such as your organization name.
  2. Set the Basic Authentication credentials: Edge email and password (user must be in the Org Admin role).
    Create an Apigee account if you don't have one.
  3. Tweak the parameters and request body as needed.
  4. Send the live request to Edge!

Import a new API Proxy

Resource Summary


Content Type

multipart/form-data, application/octet-stream


API Proxy,

Api Transformation API Collection - student


Import a new API Proxy

Uploads a ZIP-formatted API proxy configuration bundle from a local machine to an organization on Edge. If the API proxy already exists, then create a new revision of the API proxy. If the API proxy does not exist, then create it. 

By default, API proxy configurations are not validated on import. 

To validate the API proxy definition, set the validate query parameter to true. Invalid API proxy configurations are rejected, and a list of validation errors returned to the client.

Once imported, the API revision must be deployed before it can be accessed at runtime.

Resource URL /organizations/{org_name}/apis

Query Parameters

Name Values Description

Set the action to import.


Specify the API proxy name.


Specify to validate, true, or not validate, false, the proxy definition.

Header Parameters

Name Values Description

Specify Content Type: either multipart/form-data or application/octet-stream


Name Value Description

Specify the ZIP file containing the API proxy configuration bundle.

Request Body

org_name Mention the organization name true

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?