---
title: "Changes to Update a AiMcpOauth2 plugin"
method: PUT
path: "/{workspace}/plugins/{PluginId}#AiMcpOauth2"
---

# Changes to Update a AiMcpOauth2 plugin

`PUT /{workspace}/plugins/{PluginId}#AiMcpOauth2`

> Every recorded change to this endpoint, newest first.
> 11 revisions in range; 1 not diffed.

## Timeline

Changed in 3 of 11 revisions.

- **2026-04-24** `9555cbb8b259` — 3 breaking, 37 info
- **2025-11-25** `65f3141f1662` — 2 warning, 2 info
- **2025-10-09** `740b73588ef4` — 1 info

## Changes

- **2026-04-24** `9555cbb8b259` — 3 breaking, 37 info
  - the request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config` became required
  - the response property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/client_id` became optional for the status `200`
  - the response property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/introspection_endpoint` became optional for the status `200`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_by`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_claim`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_groups_claim`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_groups_optional`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_optional`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/credential_claim`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwks_cache_ttl`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwks_endpoint`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwt_claims_leeway`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_cache_ttl`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_discovery_endpoint`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_discovery_retry`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/passthrough_credentials`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/token_exchange`
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/upstream_headers`
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/condition`
  - the request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/client_id` became optional
  - the request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/introspection_endpoint` became optional
  - the `max_request_body_size` request property default value changed from `8192` to `1048576`
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_by` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_claim` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_groups_claim` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_groups_optional` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/consumer_optional` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/credential_claim` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwks_cache_ttl` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwks_endpoint` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/jwt_claims_leeway` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_cache_ttl` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_discovery_endpoint` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/metadata_discovery_retry` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/passthrough_credentials` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/token_exchange` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config/upstream_headers` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/PluginBase]/condition` to the response with the `200` status
  - the response property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/config` became required for the status `200`
  - the `max_request_body_size` response's property default value changed from `8192` to `1048576` for the status `200`
- **2025-11-25** `65f3141f1662` — 2 warning, 2 info
  - removed the request property `name`
  - removed the optional property `name` from the response with the `200` status
  - added the new optional request property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/name`
  - added the optional property `allOf[#/components/schemas/AiMcpOauth2PluginConfig]/name` to the response with the `200` status
- **2025-10-09** `740b73588ef4` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/kong-enterprise-admin-api/docs/:workspace/plugins/:PluginId#AiMcpOauth2/put.md) · [API](https://skmtc.dev/kong/apis/kong-enterprise-admin-api.md) · [Page](https://skmtc.dev/kong/apis/kong-enterprise-admin-api/changes/:workspace/plugins/:PluginId#AiMcpOauth2/put)