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

# Changes to Create an AI Gateway Agent

`POST /v1/ai-gateways/{gatewayId}/agents`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 83 revisions.

- **2026-09-25** `68d43091b84d` — 4 warning
- **2026-09-18** `f324fb7610e4` — 5 breaking, 1 warning, 37 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-09-25** `68d43091b84d` — 4 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`
  - added the new `409.00` enum value to the `status` response property for the response status `409`
- **2026-09-18** `f324fb7610e4` — 5 breaking, 1 warning, 37 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 `409`
  - 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 `409`
  - 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 `409` 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 `201`
  - 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 `409` 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 `409` 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 `409` 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
  - …3 more
- **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 `201` 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 `201` status
  - added the optional property `config/upstream` to the response with the `201` 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 `201`
- **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 `201` 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 `201` 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/post.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/post)
