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.