Konnect APIs

Base URLs

There are two types of base URLs that are used in Konnect APIs:

• Global: https://global.api.konghq.com

• Region specific: https://{REGION_CODE}.api.konghq.com

The global endpoint is used to manage region-agnostic Konnect entities that live in a global database. These APIs interact with entities that are not region specific and therefore do not have any regional boundaries. For example, identity management and IdP settings are all region-agnostic configurations applied to the organization as a whole.

The region-specific endpoints are used to manage Konnect entities that live in a specific Konnect region. These APIs interact with entities specific to a region and do not have the ability to cross regional boundaries. For example, control planes, data plane nodes, and API product listings are all region-specific entities and therefore must use the region-specific endpoint.

Spec	Insomnia link
Konnect control plane configuration beta API spec

Authentication

The recommended method of authentication for Konnect is Personal Access Token (PAT), which can be obtained from the personal access token page in Konnect. The PAT must be passed in the Authorization header of all requests, for example:

curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT'

Filtering

The Konnect API supports filtering, read the Filtering reference to learn more.

Specifications

For a full list of the API specifications supported for use in production environments, visit API Specs.