You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/api-platform/reference/limits). info

Consider the following product configuration limits as you build, manage, and review
your API program implementation. We've designed the Apigee product for stability and performance
when configured within these limits. Customers are responsible for tracking
and ensuring they stay within the configuration limits (see the
"How to check current usage" column below). Customers exceeding the limits may
experience one or more of these types of symptoms: high API latencies, low API throughput,
and failing API calls. Customers filing support cases related to issues caused by limit
exceptions may be asked to make necessary modifications to their configuration.

Limits may or may not be enforced automatically (see the "Currently enforced?" column below).
As and when we automate limit enforcement for a limit currently not enforced, we will use
commercially reasonable efforts to notify affected customers so they can take corrective
actions in advance of such enforcement.

One set of configuration limits apply to both Apigee Public Cloud and Private Cloud (on-premises)
products, and another set applies to Edge Microgateway. These limits are unrelated to your
[plan entitlements](https://apigee.com/api-management/#/pricing). Some features,
noted in this topic, are available only in Apigee Public Cloud.

## Cloud/Private Cloud


| Feature area | Limit | Currently enforced? | How to check current usage |
|---|---|---|---|
| ### API Proxies ||||
| **API proxy or shared flow zip file bundle size** (proxies other than Hosted Targets and Node.js) | 15 MB | Yes | [Check usage](https://docs.apigee.com/api-platform/fundamentals/download-api-proxies) |
| **Hosted Targets bundle size** [Hosted Targets](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview) are currently available only in Apigee Public Cloud. | 250 MB | Planned | [Check usage](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview#what-you-need-to-know-about-hosted-targets) |
| **Hosted Targets** | The [Hosted Targets](https://docs.apigee.com/api-platform/hosted-targets/hosted-targets-overview) feature is a plan entitlement. See the [Apigee Offerings](https://docs.apigee.com/api-platform/reference/subscription-entitlements) for details. |||
| **API proxy revisions** retained in history | 50 | Planned | [Check usage](https://apidocs.apigee.com/docs/api-proxies/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/revisions/get) |
| **API proxy resource file size** (such as XSL, JavaScript, Python, or JAR files). Doesn't include Hosted Targets resources. | 15 MB | Yes | [Check usage](https://docs.apigee.com/api-platform/develop/resource-files) |
| ### Extensions ||||
| **Extensions queries** | 120 requests per second to each extension | Planned | N/A |
| **Extensions response payload** | 2 MB | Planned | N/A |
| ### Quota ||||
| [Distributed quota synchronization interval](https://docs.apigee.com/api-platform/reference/policies/quota-policy#asyncconfig) | \>= 10 seconds | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/quota-policy#asyncconfig) |
| ### Persistence: Cache, KVM ||||
| **Caches at the environment scope** | 100 | Planned | [Check usage](https://apidocs.apigee.com/docs/caches/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/caches/get) |
| **Items in cache** | 2.5 million items in each cache | Planned | Planned |
| **Cache key size** | 2 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/lookup-cache-policy) |
| **Cache value size** | 256 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/lookup-cache-policy) |
| **Cache expiration** | \>=180 seconds, \<= 30 days | Planned | [Check usage](https://apidocs.apigee.com/docs/caches/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/caches/%7Bcache_name%7D/get) |
| **Key Value Maps (KVMs)** at the organization scope | 100 | Planned | [Check usage](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/keyvaluemaps/get) |
| **Key Value Maps (KVMs)** at the environment scope | 100 | Planned | [Check usage](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/keyvaluemaps/get) |
| **Key Value Maps (KVMs)** at the proxy scope | 100 shared across all API proxies defined in a given organization | Planned | [Check usage](https://apidocs.apigee.comh/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/keyvaluemaps/get) |
| **Items in KVMs** | 5 million total items in all KVMs at all scopes in an organization | Planned | Check usage: [organization](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [environment](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [API proxy](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [API proxy revision](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/revisions/%7Brevision_number%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) |
| **Key Value Map (KVM) key size^\*^** | 2 KB | Yes | Check usage: [organization](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [environment](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [API proxy](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) [API proxy revision](https://apidocs.apigee.com/docs/key-value-maps/1/routes/organizations/%7Borg_name%7D/apis/%7Bapi_name%7D/revisions/%7Brevision_number%7D/keyvaluemaps/%7Bmap_name%7D/keys/get) |
| **Key Value Map (KVM) value size^\*^** | 10 KB | Planned | [Check usage](https://docs.apigee.com/api-platform/reference/policies/key-value-map-operations-policy#GetElement) |
| ^\* For Apigee Edge for Private Cloud, the combined size of the keys and values should not exceed 15MB per KVM.^ ^To determine the size of your KVMs, you can use the [nodetool cfstats](https://docs.datastax.com/en/cassandra-oss/2.1/cassandra/tools/toolsCFstats.html) command.^ ||||
| ### Keys, Developers, Apps, Products ||||
| **Consumer key (API key) size** | 2 KB | Yes | [Check usage](https://apidocs.apigee.com/docs/developer-apps/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/apps/%7Bapp_name%7D/get) |
| **Consumer secret size** | 2 KB | Yes | [Check usage](https://apidocs.apigee.com//docs/developer-apps/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/apps/%7Bapp_name%7D/get) |
| **Custom attributes** you can set on developers, developer apps, API products, OAuth access tokens, and other Edge entities | 18 | Yes | Check usage: [Developers](https://apidocs.apigee.com/docs/developers/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/attributes/get) [Developer apps](https://apidocs.apigee.com/docs/developer-apps/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/apps/%7Bapp_name%7D/attributes/get) [API products](https://apidocs.apigee.com/docs/api-products/1/routes/organizations/%7Borg_name%7D/apiproducts/%7Bapiproduct_name%7D/attributes/get) [Access tokens](https://apidocs.apigee.com/docs/oauth-20-access-tokens/1/routes/organizations/%7Borg_name%7D/oauth2/accesstokens/%7Baccess_token%7D/get) |
| **Custom attribute name size** | 1 KB | Yes | Check usage: [Developers](https://apidocs.apigee.com/docs/developers/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/attributes/get) [Developer apps](https://apidocs.apigee.com/docs/developer-apps/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/apps/%7Bapp_name%7D/attributes/get) [API products](https://apidocs.apigee.com/docs/api-products/1/routes/organizations/%7Borg_name%7D/apiproducts/%7Bapiproduct_name%7D/attributes/get) [Access tokens](https://apidocs.apigee.com/docs/oauth-20-access-tokens/1/routes/organizations/%7Borg_name%7D/oauth2/accesstokens/%7Baccess_token%7D/get) |
| **Custom attribute value size** | 2 KB | Yes | Check usage: [Developers](https://apidocs.apigee.com/docs/developers/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/attributes/get) [Developer apps](https://apidocs.apigee.com/docs/developer-apps/1/routes/organizations/%7Borg_name%7D/developers/%7Bdeveloper_email%7D/apps/%7Bapp_name%7D/attributes/get) [API products](https://apidocs.apigee.com/docs/api-products/1/routes/organizations/%7Borg_name%7D/apiproducts/%7Bapiproduct_name%7D/attributes/get) [Access tokens](https://apidocs.apigee.com/docs/oauth-20-access-tokens/1/routes/organizations/%7Borg_name%7D/oauth2/accesstokens/%7Baccess_token%7D/get) |
| **Developers per organization** | 1 million | Planned | [Check usage](https://apidocs.apigee.com/docs/developers/1/routes/organizations/%7Borg_name%7D/developers/get) |
| ### OAuth ||||
| **OAuth access token expiration** | \>= 180 seconds, \<= 30 days | Yes | [Check usage](https://apidocs.apigee.com/docs/oauth-20-access-tokens/1/routes/organizations/%7Borg_name%7D/oauth2/accesstokens/%7Baccess_token%7D/get) |
| **OAuth refresh token expiration** | \>= 1 day, \<= 2 years | Yes | N/A |
| **OAuth access and refresh token size** | 2 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/get-oauth-v2-info-policy) |
| **Custom attributes** you can set on OAuth tokens | 18 | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/get-oauth-v2-info-policy) |
| **Custom attribute name size** | 1 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/get-oauth-v2-info-policy) |
| **Custom attribute value size** | 2 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/reference/policies/get-oauth-v2-info-policy) |
| ### Environment and Organization ||||
| **Developer portals per organization** | 10 | Planned | Planned |
| **Evaluation organizations** | Deleted after 60 days. Also see the [Google Terms of Service for Apigee Products](https://cloud.google.com/apigee/google-terms-service-apigee-products/) for evaluation accounts. | Yes | Banner in product UI |
| **Management API calls** | - 10,000 calls per minute for paid plans - 600 calls per minute for evaluation organizations | Yes | Planned |
| **Target Servers per environment** | 500 | Planned | [Check usage](https://apidocs.apigee.com/docs/targetservers/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/targetservers/get) |
| **Virtual hosts per environment** | 20 | Planned | [Check usage](https://apidocs.apigee.com/docs/virtual-hosts/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/virtualhosts/get) |
| **TLS certificates per environment** | 100 | Planned | [Check usage](https://apidocs.apigee.com/docs/keystores-and-truststores/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/keystores/%7Bkeystore_name%7D/aliases/get) |
| **Keystores per environment** | 100 | Planned | [Check usage](https://apidocs.apigee.com/docs/keystores-and-truststores/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/keystores/get) |
| **Truststores per environment** | 1000 | Planned | [Check usage](https://apidocs.apigee.com/docs/keystores-and-truststores/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/keystores/get) |
| ### Portals ||||
| **[Maximum pages per portal](https://docs.apigee.com/api-platform/publish/portal/portal-pages#creating_a_page)** | 1,000 | Yes | N/A |
| **[Maximum published APIs or API products per portal](https://docs.apigee.com/api-platform/publish/portal/publish-apis#overview)** | 1,200 | Yes | N/A |
| **[Maximum API documentation size for a published API](https://docs.apigee.com/apigee/docs/api-platform/publish/portal/publish-apis#overview)** | 4 MB | Yes | Yes |
| **[Maximum API categories per portal](https://docs.apigee.com/api-platform/publish/portal/publish-apis#view-apis)** | 200 | Yes | N/A |
| **[Maximum menu items per portal](https://docs.apigee.com/api-platform/publish/portal/portal-menus#explore-ui)** | 200 | Yes | N/A |
| **[Maximum files per portal](https://docs.apigee.com/api-platform/publish/portal/portal-files#types)** | 500 | Yes | N/A |
| **[Maximum file size](https://docs.apigee.com/api-platform/publish/portal/portal-files#types)** | 10 MB | Yes | N/A |
| **[Maximum file storage usage](https://docs.apigee.com/api-platform/publish/portal/portal-files#upload-file)** | 100 MB | Yes | N/A |
| **[Maximum audiences per portal](https://docs.apigee.com/api-platform/publish/portal/portal-audience#exploring_the_audiences_page)** | 16 | Yes | N/A |
| **[Maximum developer accounts per audience](https://docs.apigee.com/api-platform/publish/portal/portal-audience#manage_the_assignments_for_an_audience)** | 800 K (max users) | Planned | N/A |
| **[Maximum developer teams per audience](https://docs.apigee.com/api-platform/publish/portal/portal-audience#manage_the_assignments_for_an_audience)** | 200 K | Yes | N/A |
| **[Developer teams per portal](https://docs.apigee.com/api-platform/publish/portal/developer-teams#how_do_i_create_a_team)** | 200 K | Planned | N/A |
| **[Maximum developer teams a developer can be a member of](https://docs.apigee.com/api-platform/publish/portal/developer-teams#view_team_membership_by_user)** | 64 | Yes | N/A |
| **[Maximum members in a developer team](https://docs.apigee.com/api-platform/publish/portal/developer-teams#view_developer_team_details)** | 100 | Yes | N/A |
| **[Maximum characters in a portal's **Custom Scripts** JavaScript field](https://docs.apigee.com/api-platform/publish/portal/custom-scripts)** | 150,000 | Yes | N/A |
| ### System ||||
| **API proxy request URL size** | 7 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/debug/using-trace-tool-0) |
| **Request header size** | 25 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/debug/using-trace-tool-0) |
| **Response header size** | 25 KB | Yes | [Check usage](https://docs.apigee.com/api-platform/debug/using-trace-tool-0) |
| **Request/response size** (for both non-streamed and [streamed](https://docs.apigee.com/api-platform/develop/enabling-streaming) requests) A common API pattern is to fetch large amounts of data, such as images, documents, or plain text/JSON. For data sizes greater than 10 MB, Apigee recommends a signed URLs pattern. Other Google products like [GCS (Google Cloud Storage)](https://cloud.google.com/storage/docs/access-control/signed-urls) provide reference implementations using this pattern. | 10 MB | Yes for non-streamed No for streamed | cURL the API proxy |
| **Request Line Limit** The limit set for each line of a request header. | 7K | Yes | [Check Limits](https://docs.apigee.com/api-platform/debug/using-trace-tool-0) |
| **Response Line Limit** The limit set for each line of a response header. | 2K | Yes | [Check Limits](https://docs.apigee.com/api-platform/debug/using-trace-tool-0) |
| ### API Monitoring ||||
| **API Monitoring alerts** | 20 | Yes | [Check usage](https://apidocs.apigee.com/docs/alerts/1/routes/alerts/get) |
| **API Monitoring collection items** | 20 | Yes | [Check usage](https://apidocs.apigee.com/docs/collections/1/routes/collections/get) |
| **Data retention period** | 55 days | Yes | N/A |
| ### Analytics APIs (API calls only, not enforced when using the UI) ||||
| **Calls to the [Asynchronous Query API](https://apidocs.apigee.com/docs/analytics/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/queries/post) per environment** (Public Cloud only) | 7 calls per hour | No | N/A |
| **Calls to the [Stats APIs](https://apidocs.apigee.com/docs/stats/1/overview) per environment** (Public Cloud only) | Postgres: 40 calls per minute BigQuery: 12 calls per minute | No | N/A |
| **Calls to the [Data Export API](https://apidocs.apigee.com/docs/analytics/1/routes/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/analytics/exports/post) per environment** (Public Cloud only) | 70 calls per month **Monetization enabled**: 70 calls per month (standard data) and 70 calls per month (monetization data) | No | N/A |
| ### OpenAPI Specifications ||||
| [OpenAPI Specifications](https://docs.apigee.com/api-platform/publish/specs/manage-specs) | 4 MB (see note below) | Yes | Check size of file on local system |

> [!NOTE]
> **Note for OpenAPI Specifications** : Apigee encourages you to test OpenAPI Specifications that exceed **1 MB** on lower-end client machines to ensure the end-user experience is not compromised with specifications of this size. This includes all aspects of the API life cycle where the OpenAPI Specification is used, including design, development of an API proxy, publishing API reference documentation, and so on.

## Edge Microgateway


| Feature area | Limit | Currently enforced? | How to check current usage |
|---|---|---|---|
| ### API Proxies and Products ||||
| **Maximum number of API products returned by the edgemicro-auth proxy** | 500 | No |   |
| **Maximum number of API proxies supported by a single instance of Edge Microgateway** | 50 | No |   |
| ### System ||||
| **Request/response size** (for both non-streamed and [streamed](https://docs.apigee.com/api-platform/develop/enabling-streaming) requests) A common API pattern is to fetch large amounts of data, such as images, documents, or plain text/JSON. For data sizes greater than 10 MB, Apigee recommends a signed URLs pattern. Other Google products like [GCS (Google Cloud Storage)](https://cloud.google.com/storage/docs/access-control/signed-urls) provide reference implementations using this pattern. | 10 MB | No | cURL the API proxy |
| **Target connection timeout** | 600 seconds | No |   |

For product limits for the latest Apigee and Apigee hybrid products, see
[Limits](https://cloud.google.com/apigee/docs/api-platform/reference/limits).

**The information above represents current product limits. Google reserves the right to
change product features and functionality or the above limits upon posting or otherwise making them
accessible.**