*This page
applies to **Apigee** and **Apigee hybrid**.*


*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*
![](https://fonts.gstatic.com/s/i/googlematerialicons/help/v13/gm_grey-24dp/1x/gm_help_gm_grey_24dp.png)

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

- Import an API proxy using the API proxy configuration bundle to another organization, as described in [Importing an API proxy from an API proxy bundle](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/build-simple-api-proxy.md.txt#importinganapiproxyfromanapiproxybundle).
- Unzip the API proxy to your local system. This is useful for setting up file-based API proxy development in source control or viewing the file-based version of the resources. If you modify the API proxy configuration locally, you can [upload your changes as a new revision of your API proxy](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/download-api-proxies.md.txt#upload).


The following sections describe how to [download](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/download-api-proxies.md.txt#download) and [upload](https://docs.cloud.google.com/apigee/docs/api-platform/fundamentals/download-api-proxies.md.txt#upload) an API proxy configuration bundle.
For information about the expanded contents of the zip file, see
[API proxy configuration directory structure](https://docs.cloud.google.com/apigee/docs/api-platform/reference/api-proxy-configuration-reference.md.txt).

## Video

> [!NOTE]
> **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.

| Video | Description |
|---|---|
| [Download API proxy (Apigee)](https://www.youtube.com/watch?v=acVv859BlsM) | 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 UI

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

1. In the Google Cloud console, go to the **Apigee \> Proxy development \> API proxies** page.

   [Go to API proxies](https://console.cloud.google.com/apigee/proxies)
2. Select the desired API proxy.
3. Click the **Develop** tab.
4. Select the API proxy revision that you want to download in the **Revision** menu.
5. Click **More revision actions \> Export revision <var translate="no">n</var>** , where <var translate="no">n</var> specifies the selected revision.

### Apigee API


To download an API proxy configuration bundle using the API, see [Get API proxy revision](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis.revisions/get.md.txt).


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

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

For more information about the expanded contents of the zip file, see
[API proxy configuration directory structure](https://docs.cloud.google.com/apigee/docs/api-platform/reference/api-proxy-configuration-reference.md.txt#apiproxystructure).

## 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 as `zip`, 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,
see [API proxy configuration directory structure](https://docs.cloud.google.com/apigee/docs/api-platform/reference/api-proxy-configuration-reference.md.txt#apiproxystructure).

> [!NOTE]
> **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 UI

To upload an API proxy configuration bundle and create a **new revision of an existing API proxy**:

1. In the Google Cloud console, go to the **Apigee \> Proxy development \> API proxies** page.

   [Go to API proxies](https://console.cloud.google.com/apigee/proxies)
2. Select the desired API proxy.
3. Click the **Develop** tab.
4. Click **More revision actions \> Import revision**.
5. Click **Browse** and navigate to the zip file in your local directory and click **Open**.
6. Click **Import**.

### Apigee API


To upload an API proxy configuration using the API, see [Update an existing API proxy revision](https://docs.cloud.google.com/apigee/docs/reference/apis/apigee/rest/v1/organizations.apis.revisions/updateApiProxyRevision.md.txt)