Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kong CA Certificates API

A CA certificate object represents a trusted certificate authority.These objects are used by Kong Gateway to verify the validity of a client or server certificate.

Kong CA Certificates API is one of 139 APIs that Kong publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include CA Certificates. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, a GitHub repository, an API reference, authentication docs, and 1 JSON Schema.

This API exposes 9 operations across 4 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 3.14.0.

Requests are made against a single base URL, {protocol}://{hostname}:{port}{path}.

9 operations 4 paths 5 schemas 2 DELETE3 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
3.14.0
Base URL
https://konghq.com/
Authentication
API Key
Contact
License
Resource Areas
1

Authentication & Security 1

Kong CA Certificates API declares 1 security scheme for authenticating requests. An API key is passed in the header as Kong-Admin-Token (adminToken). By default, every request must be authenticated.

Paths & Operations 9

Across 4 paths, the API surfaces 9 operations — 2 DELETE, 3 GET, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

CA Certificates 9

A CA certificate object represents a trusted certificate authority. These objects are used by Kong Gateway to verify the validity of a client or server certificate.

POST
/ca_certificates
Create a new CA Certificate
create-ca_certificate body → 201401
DELETE
/ca_certificates/{CACertificateId}
Delete a CA Certificate
delete-ca_certificate 2 params → 204401
GET
/ca_certificates/{CACertificateId}
Get a CA Certificate
get-ca_certificate 1 param → 200401404
PUT
/ca_certificates/{CACertificateId}
Upsert a CA Certificate
upsert-ca_certificate 1 param body → 200401
GET
/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates
List all CA Certificates
list-ca_certificate 4 params → 200401
POST
/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates
Create a new CA Certificate
create-ca_certificate 1 param body → 201401
DELETE
/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates/{CACertificateId}
Delete a CA Certificate
delete-ca_certificate 3 params → 204401
GET
/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates/{CACertificateId}
Get a CA Certificate
get-ca_certificate 2 params → 200401404
PUT
/v2/control-planes/{controlPlaneId}/core-entities/ca_certificates/{CACertificateId}
Upsert a CA Certificate
upsert-ca_certificate 2 params body → 200401

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are CACertificate_2 (6 properties), CACertificate (6 properties), GatewayUnauthorizedError (2 properties). Each schema is shown below with its type and property counts.

GatewayUnauthorizedError
object
2 properties 2 required
CACertificate
object
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate.
6 properties 1 required
PaginationOffsetResponse
string
Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page
CACertificate_2
object
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate.
6 properties 1 required
PaginationNextResponse
string
URI to the next page (may be null)

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kong-ca-certificates-api-openapi.yml Raw ↑

Other APIs Kong publishes across the network.

Kong Gateway
Kong AI Gateway
Kong Agent Gateway
Kong MCP Registry
Kong Context Mesh
Kong Mesh
Kong Insomnia
Kong ACLs API
Kong Add-Ons API
Kong API API
Kong API Attributes API
Kong API Documentation API