---
title: "Update an AI Gateway"
method: PUT
path: "/v1/ai-gateways/{gatewayId}"
tags: ["AI Gateways"]
---

# Update an AI Gateway

`PUT /v1/ai-gateways/{gatewayId}`

Updates the configuration of an existing AI Gateway.

## Request body

- UpdateAIGatewayRequest
  - `min_runtime_version` string — The minimum AI Gateway runtime version supported by this AI Gateway. This is the lowest data plane version that may receive configuration from it, and it controls which features the API accepts. It may be lowered only when no configuration already stored uses a feature that requires a runtime version above the requested one. Otherwise the request is rejected, naming the entities and fields that stand in the way so that they can be removed or downgraded first. When not specified, the minimum runtime version is left unchanged. When runtime_auto_upgrade is enabled (the default), this value is raised automatically to track the minimum runtime version reported across connected data planes, so any value set here may be superseded as the fleet upgrades.
  - `runtime_auto_upgrade` boolean — Whether the control plane should automatically raise min_runtime_version to match the DP fleet's minimum runtime version (the lowest AI Gateway runtime version reported across all connected data planes) as that value increases.
  - `display_name` string, required — The display name for this AI Gateway.
  - `name` string, required — The name for this AI Gateway. This value is immutable after creation.
  - `description` string — The description of the AI Gateway.
  - `proxy_urls` AIGatewayProxyURL[] — Array of proxy URLs associated with reaching the data-planes connected to a control-plane.
    - `host` string, required — Hostname of the proxy URL.
    - `port` integer, required — Port of the proxy URL.
    - `protocol` string, required — Protocol of the proxy URL.
  - `labels` PublicLabels — 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 "_".

## Response `200`

AI Gateway updated successfully.

- AIGateway
  - `display_name` string, required — The display name for this AI Gateway.
  - `name` string, required — The name for this AI Gateway. This value is immutable after creation.
  - `description` string — The description of the AI Gateway.
  - `proxy_urls` AIGatewayProxyURL[] — Array of proxy URLs associated with reaching the data-planes connected to a control-plane.
    - `host` string, required — Hostname of the proxy URL.
    - `port` integer, required — Port of the proxy URL.
    - `protocol` string, required — Protocol of the proxy URL.
  - `labels` PublicLabels — 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 "_".
  - `id` string, uuid, required — Contains a unique identifier used for this resource.
  - `min_runtime_version` string — The minimum AI Gateway runtime version supported by this AI Gateway. This is the lowest data plane version that may receive configuration from it, and it controls which features the API accepts. Data planes older than this version still connect for topology visibility. When not specified, the latest generally available runtime version is used. When runtime_auto_upgrade is enabled (the default), this value is raised automatically to track the minimum runtime version reported across connected data planes, so any value set here may be superseded as the fleet upgrades.
  - `runtime_auto_upgrade` boolean — Whether the control plane should automatically raise min_runtime_version to match the DP fleet's minimum runtime version (the lowest AI Gateway runtime version reported across all connected data planes) as that value increases.
  - `deployment_type` 'hybrid' | 'managed' | 'serverless', required — How this AI Gateway's control plane is deployed.
  - `endpoints` object, required — Object containing AI Gateway access endpoints.
    - `configuration` string, url, required — Configuration Endpoint.
    - `telemetry` string, url, required — Telemetry Endpoint.
  - `config_version` string — The version identification of the latest configuration of the gateway. Any change to an entity under this gateway can result in a new version. The config_version is generated in the control plane and used to verify if an AI Gateway node configuration is up to date.
  - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

## Changes

- **2026-09-30** `f530bf400198` — 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-25** `4a02153f2e60` — 4 breaking, 34 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `429`
  - …34 more
- **2026-09-18** `5ca78660b97c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kong/apis/konnect-api/changes/v1/ai-gateways/:gatewayId/put.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api/revisions/f530bf400198?raw)