AIGatewayRouteConfig
objectConfiguration for an AI Gateway route.
A list of IP destinations of incoming connections that match this route when using stream routing. Each entry is an object with fields ip (optionally in CIDR range notation) and/or port.
Example:{"ip":"10.1.0.0/16","port":1234}
Show Child Parameters
One or more lists of values indexed by header name that will cause this route to match if present in the request. The Host header cannot be used with this attribute: hosts should be specified using the hosts attribute. When headers contains only one value and that value starts with the special prefix ~*, the value is interpreted as a regular expression.
Example:{"version":["v1","v2"]}
A list of domain names that match this route. Note that the hosts value is case sensitive.
Example:foo.example.com
The status code Kong responds with when all properties of a route match except the protocol i.e. if the protocol of the request is HTTP instead of HTTPS. Location header is injected by Kong if the field is set to 301, 302, 307 or 308. Note: This config applies only if the route is configured to only accept the https protocol.
Default:426
Example:56c4566c-14cc-4132-9011-4139fcbbe50a
A list of HTTP methods that match this route.
The name of the route. Route names must be unique, and they are case sensitive. For example, there can be two different routes named test and Test.
Controls how the service path, route path and requested path are combined when sending a request to the upstream. See above for a detailed description of each behavior.
Default:v0
A list of paths that match this route.
When matching a route via one of the hosts domain names, use the request Host header in the upstream request headers. If set to false, the upstream Host header will be that of the service’s host.
Default:false
An array of the protocols this route should allow. See the route Object section for a list of accepted protocols. When set to only https, HTTP requests are answered with an upgrade error. When set to only http, HTTPS requests are answered with an error.
Default:http, https
A number used to choose which route resolves a given request when several routes match it using regexes simultaneously. When two routes match the path and have the same regex_priority, the older one (lowest created_at) is used. Note that the priority for non-regex routes is different (longer non-regex routes are matched before shorter ones).
Default:0
Whether to enable request body buffering or not. With HTTP 1.1, it may make sense to turn this off on services that receive data with chunked transfer encoding.
Default:true
Whether to enable response body buffering or not. With HTTP 1.1, it may make sense to turn this off on services that send data with chunked transfer encoding.
Default:true
The service this route is associated to. This is where the route proxies traffic to.
Show Child Parameters
A list of SNIs that match this route when using stream routing.
A list of IP sources of incoming connections that match this route when using stream routing. Each entry is an object with fields ip (optionally in CIDR range notation) and/or port.
Example:{"ip":"10.1.0.0/16","port":1234}
Show Child Parameters
When matching a route via one of the paths, strip the matching prefix from the upstream request URL.
Default:true
An optional set of strings associated with the route for grouping and filtering.
AIGatewayLoggingConfig
objectConfiguration for AI Gateway logging.
Default:false
Default:false
AIGatewayMCPServerConfig
objectRouting, logging, and server configuration for the MCP Server.
Configuration for an AI Gateway route.
Show Child Parameters
Configuration for AI Gateway logging.
Show Child Parameters
Default:1048576
Show Child Parameters
CreateAIGatewayMCPServerRequest
One OfAllowed values:conversion-only
The display name for the MCP Server.
Example:Kong Air Flights
A user-defined unique identifier for this MCP server, used as a stable human-readable reference.
Example:kongair-flights
Routing, logging, and server configuration for the MCP Server.
Show Child Parameters
A tool exposed by the MCP Server, mapped to a backend HTTP endpoint.
Show Child Parameters
Lightweight object used to reference a policy instance, identified by its ref.
Show Child Parameters
Public labels store information about an entity that can be used for filtering a list of objects.
Public labels are intended to store PUBLIC metadata.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"category":"finance"}
Indicates the managing entities for a resource. A maximum of 5 keys is allowed.
Keys must be 63 characters or less, starting and ending with an alphanumeric character,
and may include dashes (-), underscores (_), and dots (.).
Values must be non-empty strings of 127 characters or less.
Keys and values must not contain spaces or control characters, and are case-insensitive.
Example:{"team":"platform","owner":"kong"}
UpdateAIGatewayMCPServerRequest
One OfAllowed values:conversion-only
The display name for the MCP Server.
Example:Kong Air Flights
A user-defined unique identifier for this MCP server, used as a stable human-readable reference.
Example:kongair-flights
Routing, logging, and server configuration for the MCP Server.
Show Child Parameters
A tool exposed by the MCP Server, mapped to a backend HTTP endpoint.
Show Child Parameters
Lightweight object used to reference a policy instance, identified by its ref.
Show Child Parameters
Public labels store information about an entity that can be used for filtering a list of objects.
Public labels are intended to store PUBLIC metadata.
Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.
Example:{"category":"finance"}
Indicates the managing entities for a resource. A maximum of 5 keys is allowed.
Keys must be 63 characters or less, starting and ending with an alphanumeric character,
and may include dashes (-), underscores (_), and dots (.).
Values must be non-empty strings of 127 characters or less.
Keys and values must not contain spaces or control characters, and are case-insensitive.
Example:{"team":"platform","owner":"kong"}