Understanding Apigee X KVM limits

I have some doubts about the limits shown in this documentation:

Key Value Maps (KVMs) at the organization scope 100
Key Value Maps (KVMs) at the environment scope 900

Does the counter apply independently for each environment, or globally to all of them? For example, I have 5 organizations and each one has only 1 environment with 200 KVMs… So I have 200 KVMs per environment, but I have 1000 KVMs environment-scoped in total (adding up all the organizations). Am I trespassing the 900 KVMs limit?

Also, in this scenario (each organization has one and only one environment), I guess that there is no practical difference between an organization-scoped KVM and an environment-scoped KVM, so I would have 100 more KVMs available for each environment, am I right?

Hi @JAAO, thanks for bringing your question about KVM limits to the community :slightly_smiling_face:

While we wait for the community to share their insights, we highly recommend checking out some of our latest Knowledge Hub content to continue your learning, such as our recent piece on Apigee API Hub to MCP Registry Tutorial.

We would also love to invite you to our upcoming Community TechTalk this Thursday, July 23, 2026: Apigee AI Portals for Model, Tool & Agent Self-Service. We will be exploring how to turn traditional portals into self-service hubs for enterprise AI.

We will keep an eye on this thread to make sure you get an answer!

Hi @JAAO KVM’s can be created at 3 different scopes: organisation, environment and proxy.

Scope Description
API proxy Only the API proxy can access the KVM.
Environment All API proxies in a specific environment can access the KVM. For example, you may want API proxies deployed in the prod environment to not have access to KVMs in the test environment. If you want the same KVM keys to be available in production, create a parallel KVM scoped to the prod environment.
Organization All API proxies in all environments can access the KVM.

The environment level limits are independent for each environment of Apigee, so 2 environment would mean 900+900 KVM.

So, yes. In case you have 1 environment per organization, you can have 1000 KVMs (100 for org + 900 for env).