Naming guidelines

This page applies to Apigee and Apigee hybrid.

View Apigee Edge documentation.

The following table lists naming guidelines for common Apigee components:

Named ItemMaximum charactersAllowed characters
API key255Alphanumeric and the following: _ -
API product100(1)Alphanumeric, space, and the following: _ - . # $ %
App: developer and companyAlphanumeric, space, and the following: _ - . # $ %. Must begin with an alpha character or digit
Email IDValid email address syntax. (Hybrid only) lower case only
Environment name32Alphanumeric, space, and the following: _ - .
Instance name32Lowercase alphanumeric, hyphens, and numbers. Must begin with an alpha character; cannot end with a hyphen. Follows the pattern /^[a-z0-9-]+$/
Key value map (KVM) nameAlphanumeric, space, and the following: _ - . # $ %
Key value map (KVM) key nameAlphanumeric, space, and the following: _ - . $
Organization name32Lowercase letters only; it should not contain spaces, underscores, or periods.
Password for Apigee administrators>=8, <= 100Alphanumeric, special characters. The password must have at least one lowercase character, one uppercase character, one number, and one special character.
Policy name (or step definition)255Alphanumeric, space, and the following: _ - .
Proxy name2048(2)Alphanumeric, space, and special characters. Long names with many special characters might cause rendering or other issues and should be avoided.
Resource file names255Alphanumeric, space, and the following: : / \ ! @ # $ % ^ & { } [ ] ( ) _ + - = , . ~ '
Resource file types255Alphanumeric and the following: _ - .

(1) Total length including organization name and product display name, in this form: <org_name>@@@<display_name>. For example, "MyOrg1@@@API Product Name".

(2) Including http:// or https://.

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

Last updated 2025-04-24 UTC.