Kong Admin API

All Gateway Documentation

What is the Kong Admin API?

The Admin API is an internal RESTful API designed for administration purposes. It provides full control over Kong Gateway.

Requests to the Admin API can be sent to any node in the cluster, and Kong will keep the configuration consistent across all nodes.

By default, the Admin API is exposed on the following ports:

8001 for HTTP
8444 for HTTPS

This can be customized with the admin_listen parameter in in the Kong Gateway configuration.

Specification

API specification

Learn how to use the Admin API.

Run in Insomnia

Open the Admin API specification in Insomnia.

Security

Secure the Admin API

Learn how to secure the Admin API against unwanted access.

Enable RBAC

Use the Admin API to secure Kong Gateway with Role-Based Access Control.

Frequently asked questions

Does the Kong Admin API work with Gateway entities in Konnect?

Can I use the Admin API in DB-less mode?

How can I send a request for a specific Workspace?

You can target a specific Workspace by prefixing any endpoint with the Workspace name or ID. For example, you can use the following command to get all services from a Workspace named SRE:

curl -i -X GET http://localhost:8001/SRE/services

Copied to clipboard!

If no Workspace is specified, the request applies to the default Workspace.