Using the Konnect API
Kong Konnect provides a RESTful admin API for administration.
This API is designed for internal use and provides full control over a Konnect
organization and its entities, so care should be taken when setting up
For a list of all endpoints, see:
You can run Konnect API requests using
Insomnia, Kong’s open-source API client. If you have
Insomnia installed, click the button below to import the Konnect
Note: If you have trouble importing the spec into Insomnia,
update to the latest Insomnia version. If you have automatic
updates enabled but are still running an older version, restart Insomnia
to trigger the update.
Making a Request to the Konnect API
Requests to the Konnect API must be authenticated. A request without
authentication will fail.
Try to access
/api/control_planes without any authentication:
Since you didn’t specify any authentication, the request should fail with a
401 Unauthorized error.
Log into the Konnect API
Fetch a session cookie. Log in to Konnect using an authorized Konnect user’s
email and password:
The response includes a session cookie. Copy the
<cookie-value> portion of
content-type: application/json; charset=utf-8
strict-transport-security: max-age=15552000; includeSubDomains
x-xss-protection: 1; mode=block
set-cookie: <cookie-value>; Path=/; Expires=Wed, 23 Dec 2020 18:49:4GMT; HttpOnly; SameSite=Strict
date: Wed, 23 Dec 2020 17:49:48 GMT
Make a request with the session cookie
Copy the session cookie and use it to fetch
This time, you should get an
HTTP 200 response code and the control plane