Downloading and uploading an API proxy configuration bundle

This pageapplies toApigee andApigee hybrid.

View Apigee Edge documentation.

You may want to download an API proxy configuration bundle (as a zip file) from Apigee to perform one of the following tasks:

The following sections describe how todownload andupload an API proxy configuration bundle. For information about the expanded contents of the zip file, seeAPI proxy configuration directory structure.

Video

Note: This video was recorded with a previous version of the Apigee UI; however, the concepts are still valid.

Watch the following video to learn more about downloading and uploading an API proxy configuration bundle.

VideoDescription
Download API proxy (Apigee)Download an API proxy using the Apigee UI and API.

Downloading an API proxy configuration bundle

Download an API proxy configuration bundle, as described in the following sections.

Apigee Cloud console

To download an API proxy configuration bundle using the Google Cloud console:

  1. In the Google Cloud console, go to theProxy development> API proxies page.

    Go to API proxies

  2. Select the desired API proxy.
  3. Click theDevelop tab.
  4. Select the API proxy revision that you want to download in theRevision menu.
  5. ClickMore revision actions> Export revisionn, wheren specifies the selected revision.

Classic Apigee UI

To download an API proxy configuration bundle using the Apigee UI:

  1. Open the API proxy in the API proxy editor.
  2. Click theDevelop tab.
  3. Select the API proxy revision that you want to download in theRevision drop-down.
  4. SelectRevisionn > Export revisionn, wheren specifies the selected revision.

Apigee API

To download an API proxy configuration bundle using the API, seeGet API proxy revision.

To view the contents of the API proxy configuration bundle, create a new directory and expand the zip file using a utility such asunzip, as shown in the following example:

mkdir myappdirunzip ./my-app_app_rev3_2019_04_20.zip -d myappdir

For more information about the expanded contents of the zip file, seeAPI proxy configuration directory structure.

Uploading an API proxy configuration bundle

Before you upload an API proxy configuration bundle, re-archive the API proxy configuration bundle directory if you have modified it, including any new or changed files. You can use a utility such aszip, as the following example shows:

zip my-new-proxy.zip -r .

The top-level directory in the zip file must be/apiproxy. For more information about the required directory structure, seeAPI proxy configuration directory structure.

Note: There are no special requirements for the zip file name. For example, you do not need to increment the revision number or specify the date in the file name, unless you find it useful for debugging or source control.

Upload an API proxy configuration bundle, as described in the following sections.

Apigee Cloud console

To upload an API proxy configuration bundle and create anew revision of an existing API proxy:

  1. In the Google Cloud console, go to theProxy development> API proxies page.

    Go to API proxies

  2. Select the desired API proxy.
  3. Click theDevelop tab.
  4. ClickMore revision actions> Import revision.
  5. ClickBrowse and navigate to the zip file in your local directory and clickOpen.
  6. ClickImport.

Classic Apigee UI

To upload an API proxy configuration bundle andcreate a new API proxy, seeImporting an API proxy from an API proxy bundle

To upload an API proxy configuration bundle and create anew revision of an existing API proxy:

  1. Open the API proxy in API proxy editor.
  2. Click theDevelop tab.
  3. Select the API proxy revision that you want to download in theRevision drop-down.
  4. SelectRevisionn > Import revision.
  5. ClickChoose File and navigate to the zip file in your local directory and clickOpen.
  6. ClickUpload

    If you get an error, such asBundle is invalid. Empty bundle, then make sure your zip file's top-level directory is/apiproxy. If it isn't, re-archive your API proxy configuration files from the root of the expanded directory.

After uploading your new API proxy configuration, Apigee increments the revision number and displays the new revision. Apigeedoes not deploy the new revision automatically after you upload it. To deploy the new revision, seeDeploying an API proxy.

Apigee API

To upload an API proxy configuration using the API, seeUpdate an existing API proxy revision

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.