You are viewing the Apigee Management API reference documentation. For the main product docs, and to search all docs, go to https://docs.apigee.com. For cross-site search, click Search all in the search results.

About the Apigee management APIs

To view the available management APIs, use the left navigation bar or the API index page.

Where to begin

You can get started calling the Apigee management API with the following helpful resources:

Using the Edge management API

As an alternative to managing your Edge organization with the management UI, you can manage it using a RESTful API called the Edge management API. That means you can use the API to create, configure, and manage API proxies and API products, create and manage apps and app developers, and to perform many other types of operations programmatically, using any HTTP client. The API resources exposed by the Edge management API support JSON and XML, and are secured using HTTP Basic Authentication and OAuth.

Edge also supports Security Assertion Markup Language (SAML) 2.0 as the authentication mechanism. With SAML enabled, access to the Edge UI and Edge management API still uses OAuth2 access tokens. However, now you can generate these tokens from SAML assertions returned by an identity provider.

You need to provide the email address and password associated with your organization on Apigee Edge with each API call that you make, and the user making the calls must be in a role that's allowed to make the calls, such as an Organization Administrator.

Following RESTful principles, you can call HTTP GET, POST, PUT, and DELETE methods on any of the API resources.

Authentication

In the previous cURL example, notice the required -u email:password. Your Apigee account includes a username and email, along with a password. While you can log into the Edge management UI with your username, you must make management API calls with your Apigee account email address. Your username will not work in management API calls.

You can also make calls to the management API using an OAuth token or SAML. For more information, see:

About Core Persistence Services (CPS)

Like many of our customers, Apigee has embraced a microservices-based architecture, and this has improved the reliability and scalability of our products, as well as the way we develop and deliver them. As part of that effort, we're rolling out our next generation Core Persistence Services (CPS) in a limited fashion, and new customers will begin to use these new management APIs. Eventually, all customers will be on CPS. If your organization has CPS enabled, a property called features.isCpsEnabled is set on your org. To view organization-level properties, call the Get Organization API with your Apigee account credentials. Here's the cURL version: