---
title: "Changes to Update an AI Gateway Agent"
method: PUT
path: "/v1/ai-gateways/{gatewayId}/agents/{agentIdOrName}"
---

# Changes to Update an AI Gateway Agent

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 2 breaking, 2 warning, 1 info
- **2026-10-05** `1efb48111817`: 1 warning
- **2026-09-25** `68d43091b84d`: 3 warning
- **2026-09-18** `f324fb7610e4`: 4 breaking, 1 warning, 31 info
- **2026-08-24** `46dabd88efd3`: 8 warning, 6 info
- **2026-08-12** `b1ea6bd77dec`: 4 info
- **2026-08-07** `0261aef4b1e2`: 1 warning, 1 info
- **2026-08-04** `d7d38387ab86`: 2 info
- **2026-07-17** `051ca2cf71d9`: 2 warning
- **2026-07-16** `a2e95e9f6c80`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 2 breaking, 2 warning, 1 info
  - added `#/components/schemas/AIGatewayAllowWhenACL, #/components/schemas/AIGatewayDenyWhenACL` to the `access/acls` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added `#/components/schemas/AIGatewayAllowWhenACL, #/components/schemas/AIGatewayDenyWhenACL` to the `access/acls` request property `oneOf` list
- **2026-10-05** `1efb48111817`: 1 warning
  - the `config/logging/max_payload_size` request property's exclusiveMinimum was set to `true`
- **2026-09-25** `68d43091b84d`: 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-18** `f324fb7610e4`: 4 breaking, 1 warning, 31 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`
  - changed the pattern of the request property `name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `400`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `403`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `429`
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `403` status
  - added the optional property `type` to the response with the `404` status
  - added the optional property `type` to the response with the `429` status
  - the response property `detail` became required for the status `401`
  - the response property `instance` became required for the status `401`
  - the response property `status` became required for the status `401`
  - the response property `title` became required for the status `401`
  - the `name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$` for the status `200`
  - added the required property `detail` to the response with the `400` status
  - added the required property `detail` to the response with the `403` status
  - added the required property `detail` to the response with the `404` status
  - added the required property `detail` to the response with the `429` status
  - added the required property `instance` to the response with the `400` status
  - added the required property `instance` to the response with the `403` status
  - added the required property `instance` to the response with the `404` status
  - added the required property `instance` to the response with the `429` status
  - added the required property `invalid_parameters` to the response with the `400` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `404` status
  - added the required property `status` to the response with the `429` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `403` status
  - added the required property `title` to the response with the `404` status
  - added the required property `title` to the response with the `429` status
- **2026-08-24** `46dabd88efd3`: 8 warning, 6 info
  - the `config/logging/max_payload_size` request property's max was set to `2147483646.00`
  - the `config/max_request_body_size` request property's max was set to `2147483646.00`
  - the `config/route/https_redirect_status_code` request property's max was set to `599.00`
  - the `config/route/regex_priority` request property's max was set to `2147483647.00`
  - the `config/logging/max_payload_size` request property's min was set to `0.00`
  - the `config/max_request_body_size` request property's min was set to `0.00`
  - the `config/route/https_redirect_status_code` request property's min was set to `100.00`
  - the `config/route/regex_priority` request property's min was set to `-2147483648.00`
  - added the new optional request property `access/auth_strategies`
  - request property `access/identity_providers` deprecated
  - request property `access/identity_providers/items/` deprecated
  - added the optional property `access/auth_strategies` to the response with the `200` status
  - response property `access/identity_providers` deprecated
  - response property `access/identity_providers/items/` deprecated
- **2026-08-12** `b1ea6bd77dec`: 4 info
  - added the new optional request property `config/proxy`
  - added the new optional request property `config/upstream`
  - added the optional property `config/proxy` to the response with the `200` status
  - added the optional property `config/upstream` to the response with the `200` status
- **2026-08-07** `0261aef4b1e2`: 1 warning, 1 info
  - changed the pattern of the request property `name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - the `name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` response's property pattern was changed from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$` for the status `200`
- **2026-08-04** `d7d38387ab86`: 2 info
  - added the new optional request property `access/identity_providers`
  - added the optional property `access/identity_providers` to the response with the `200` status
- **2026-07-17** `051ca2cf71d9`: 2 warning
  - removed the request property `config/logging/statistics`
  - removed the optional property `config/logging/statistics` from the response with the `200` status
- **2026-07-16** `a2e95e9f6c80`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v1/ai-gateways/:gatewayId/agents/:agentIdOrName/put.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-gateways/:gatewayId/agents/:agentIdOrName/put)
