Get an AI Gateway Model
Returns the details of a specific AI Gateway model.
Path Parameters
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Response
application/json
Response
A successful response returning the AI Gateway Model.
AIGatewayModel
Configuration for an AI Gateway model.
One OfThe display name for this policy instance.
Example:My GPT 5 model
A user-defined unique identifier for this model, used as a stable human-readable reference.
Example:my-gpt-5-model
Whether the model is enabled.
Default:true
Example:true
Access control rules for allowing or denying consumer groups access to this model.
Show Child Parameters
Routing, logging, and load balancing configuration for the model.
Show Child Parameters
Request and response format supported by this model.
Show Child Parameters
A target model instance that this model entry routes requests to.
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"}
Allowed values:model
List of AI capabilities enabled for this model.
Allowed values:chatembeddingsassistantsresponsesaudio-transcriptionsaudio-translationsimage-generationimage-editsvideo-generationsrealtime
Authentication
Path Parameters
Update an AI Gateway Model
Updates the configuration of an existing AI Gateway model.
Path Parameters
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Body
application/json
Body
UpdateAIGatewayModelRequest
Configuration for an AI Gateway model.
One OfThe display name for this policy instance.
Example:My GPT 5 model
A user-defined unique identifier for this model, used as a stable human-readable reference.
Example:my-gpt-5-model
Whether the model is enabled.
Default:true
Example:true
Access control rules for allowing or denying consumer groups access to this model.
Show Child Parameters
Routing, logging, and load balancing configuration for the model.
Show Child Parameters
Request and response format supported by this model.
Show Child Parameters
A target model instance that this model entry routes requests to.
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"}
Allowed values:model
List of AI capabilities enabled for this model.
Allowed values:chatembeddingsassistantsresponsesaudio-transcriptionsaudio-translationsimage-generationimage-editsvideo-generationsrealtime
Response
application/json
Response
Model updated successfully.
AIGatewayModel
Configuration for an AI Gateway model.
One OfThe display name for this policy instance.
Example:My GPT 5 model
A user-defined unique identifier for this model, used as a stable human-readable reference.
Example:my-gpt-5-model
Whether the model is enabled.
Default:true
Example:true
Access control rules for allowing or denying consumer groups access to this model.
Show Child Parameters
Routing, logging, and load balancing configuration for the model.
Show Child Parameters
Request and response format supported by this model.
Show Child Parameters
A target model instance that this model entry routes requests to.
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"}
Allowed values:model
List of AI capabilities enabled for this model.
Allowed values:chatembeddingsassistantsresponsesaudio-transcriptionsaudio-translationsimage-generationimage-editsvideo-generationsrealtime
Authentication
Path Parameters
Body
Delete an AI Gateway Model
Removes a specific AI Gateway model.
Path Parameters
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Response
Response
Model deleted successfully.
Authentication
Path Parameters
AI Gateway Policies
Policies that control security, rate-limiting, and guardrail behavior for the AI Gateway.
List AI Gateway Policies
Returns a list of policies configured for the AI Gateway.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Request the next page of data, starting with the item after this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Path Parameters
Contains a unique identifier used for this resource.
Example:bf138ba2-c9b1-4229-b268-04d9d8a6410b
Response
application/json
Response
A successful response listing AI Gateway Policies.
Show Child Parameters
Pagination metadata.