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

# Changes to Create an AI Gateway Identity Provider

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 87 revisions.

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
- **2026-09-25** `68d43091b84d`: 3 warning
- **2026-09-18** `f324fb7610e4`: 4 breaking, 2 warning, 32 info
- **2026-08-24** `46dabd88efd3`: 5 info
- **2026-08-20** `b576ea92fca2`: 4 info
- **2026-08-11** `4fef3868064f`: 6 breaking, 40 info
- **2026-08-07** `0261aef4b1e2`: 2 warning, 2 info
- **2026-07-22** `cbe9c5753e61`: 2 info
- **2026-07-17** `051ca2cf71d9`: 2 info
- **2026-07-16** `a2e95e9f6c80`: 1 info

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - 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`
- **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 `409.00` enum value to the `status` response property for the response status `409`
- **2026-09-18** `f324fb7610e4`: 4 breaking, 2 warning, 32 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 `409`
  - the response's body type changed from no type to `object` for status `429`
  - changed the pattern of the request property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._:-]{1,256}$` to `^[A-Za-z0-9._:@-]{1,256}$`
  - changed the pattern of the request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/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 `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 `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 `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/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`
  - the `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/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 `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 `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 `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
  - added the required property `title` to the response with the `409` status
  - added the required property `title` to the response with the `429` status
- **2026-08-24** `46dabd88efd3`: 5 info
  - endpoint deprecated
  - request property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/` deprecated
  - request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/` deprecated
  - response property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/` deprecated
  - response property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/` deprecated
- **2026-08-20** `b576ea92fca2`: 4 info
  - added the new optional request property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/config/principals`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/principals`
  - added the optional property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/config/principals` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/principals` to the response with the `201` status
- **2026-08-11** `4fef3868064f`: 6 breaking, 40 info
  - the `type` request property const value `key-auth` was added
  - the `type` request property const value `openid-connect` was added
  - removed the enum value `key-auth` of the request property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/type`
  - removed the enum value `openid-connect` of the request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/type`
  - the `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/` response's property type changed from no type to `object` for status `201`
  - the `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse -> subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/` response's property type changed from no type to `object` for status `201`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/audience_required`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/cache_introspection`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/client_alg`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/client_auth`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/consumer_by`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/credential_claim`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/hide_credentials`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/http_proxy`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/http_proxy_authorization`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/http_version`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/https_proxy`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/https_proxy_authorization`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/introspection_endpoint`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/jwks_endpoint`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/keepalive`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/leeway`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/mtls_introspection_endpoint`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/no_proxy`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/timeout`
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/upstream_headers`
  - added the optional property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/config` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/labels` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/managed_by` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse -> subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse -> subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/labels` to the response with the `201` status
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse -> subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/managed_by` to the response with the `201` status
  - removed `#/components/schemas/AIGatewayIdentityProviderKeyAuth, #/components/schemas/AIGatewayIdentityProviderResponseProperties` from the `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/AIGatewayIdentityProviderOpenIDConnect, #/components/schemas/AIGatewayIdentityProviderResponseProperties` from the `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse -> subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/` response property `allOf` list for the response status `201`
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/created_at` to the response with the `201` status
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/display_name` to the response with the `201` status
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/id` to the response with the `201` status
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/name` to the response with the `201` status
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/type` to the response with the `201` status
  - added the required property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse -> subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/updated_at` to the response with the `201` status
  - …6 more
- **2026-08-07** `0261aef4b1e2`: 2 warning, 2 info
  - changed the pattern of the request property `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - changed the pattern of the request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/name/allOf[#/components/schemas/AIGatewayEntityIdentifier]/` from `^[A-Za-z0-9._-]{1,256}$` to `^[A-Za-z0-9._:-]{1,256}$`
  - the `oneOf[subschema #1: AIGatewayIdentityProviderKeyAuthResponse]/allOf[subschema #1: AIGatewayIdentityProviderKeyAuthConfig]/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`
  - the `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse]/allOf[subschema #1: AIGatewayIdentityProviderOpenIDConnectConfig]/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-07-22** `cbe9c5753e61`: 2 info
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/consumer_groups_optional`
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse]/allOf[subschema #1: AIGatewayIdentityProviderOpenIDConnectConfig]/config/consumer_groups_optional` to the response with the `201` status
- **2026-07-17** `051ca2cf71d9`: 2 info
  - added the new optional request property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectConfig]/config/consumer_groups_claim`
  - added the optional property `oneOf[subschema #2: AIGatewayIdentityProviderOpenIDConnectResponse]/allOf[subschema #1: AIGatewayIdentityProviderOpenIDConnectConfig]/config/consumer_groups_claim` to 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/identity/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/identity/post)