Plugins

Update a AiProxy plugin

Update a AiProxy plugin

put/v2/control-planes/{controlPlaneId}/core-entities/plugins/{PluginId}#AiProxy

Request body

conditionstring nullable

An expression used for conditional control over plugin execution. If the expression evaluates to true during the request flow, the plugin is executed; otherwise, it is skipped.

created_atinteger nullable

Unix epoch when the resource was created.

enabledboolean nullable

Whether the plugin is applied.

idstring nullable

A string representing a UUID (universally unique identifier).

instance_namestring nullable

A unique string representing a UTF-8 encoded name.

name'ai-proxy' required

The name of the Plugin that's going to be added. Currently, the Plugin must be installed in every Kong instance separately.

tagsstring[] nullable

An optional set of strings associated with the Plugin for grouping and filtering.

updated_atinteger nullable

Unix epoch when the resource was last updated.

protocolsstring[]

A list of the request protocols that will trigger this plugin. The default value, as well as the possible values allowed on this field, may change depending on the plugin type. For example, plugins that only work in stream mode will only support tcp and tls.

Response

AiProxy plugin

conditionstring nullable

An expression used for conditional control over plugin execution. If the expression evaluates to true during the request flow, the plugin is executed; otherwise, it is skipped.

created_atinteger nullable

Unix epoch when the resource was created.

enabledboolean nullable

Whether the plugin is applied.

idstring nullable

A string representing a UUID (universally unique identifier).

instance_namestring nullable

A unique string representing a UTF-8 encoded name.

name'ai-proxy' required

The name of the Plugin that's going to be added. Currently, the Plugin must be installed in every Kong instance separately.

tagsstring[] nullable

An optional set of strings associated with the Plugin for grouping and filtering.

updated_atinteger nullable

Unix epoch when the resource was last updated.

protocolsstring[]

A list of the request protocols that will trigger this plugin. The default value, as well as the possible values allowed on this field, may change depending on the plugin type. For example, plugins that only work in stream mode will only support tcp and tls.

Changes

Changed in 19 of the 52 revisions of this API.7228207

Aug 26, 202672502a676a92110See the full diff
- ▲
  the request property ///// became not nullable
  request-property-became-not-nullable
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 11, 202662c54f1094bb11See the full diff
- ▲
  the request property ////// became required
  request-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
Apr 24, 20267d6a643707d9418See the full diff
- ●
  added the new databricks enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new deepseek enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new ollama enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new vllm enum value to the ////// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new databricks enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new deepseek enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new ollama enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new vllm enum value to the request property //////
  request-property-enum-value-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //// to the response with the status
  response-optional-property-added
Feb 16, 20262b2a72c67bd211See the full diff
- ●
  added the new video/generation enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the new video/generation enum value to the request property /////
  request-property-enum-value-added
Jan 13, 2026ad02b4e24eb2511See the full diff
- ●
  added the new anthropic enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cerebras enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new dashscope enum value to the ////// response property for the response status
  response-property-enum-value-added
- ●
  added the new video/v1/videos/generations enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new xai enum value to the ////// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  the request property default value changed from 8192 to 1048576
  request-property-default-value-changed
- ○
  added the new anthropic enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new cerebras enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new dashscope enum value to the request property //////
  request-property-enum-value-added
- ○
  added the new video/v1/videos/generations enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new xai enum value to the request property //////
  request-property-enum-value-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  the response's property default value changed from 8192 to 1048576 for the status
  response-property-default-value-changed
Oct 29, 202519e869275e2822See the full diff
- ▲
  the //// request property type changed from string to no type
  request-property-type-changed
- ▲
  the //// response's property type changed from string to no type for status
  response-property-type-changed
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 16, 2025f030590166225See the full diff
- ▲
  the request property ////// became not nullable
  request-property-became-not-nullable
- ▲
  the request property ////// became not nullable
  request-property-became-not-nullable
- ▲
  the //// request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the //// request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the ////// request property's minLength was increased from 0 to 1
  request-property-min-length-increased
Aug 22, 202596118a9cd7f44373See the full diff
- ▲
  the response property ///// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ///// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property //////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ▲
  the response property ////// became nullable for the status
  response-property-became-nullable
- ○
  the request property ///// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ///// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property //////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property /////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property ////// became nullable
  request-property-became-nullable
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value 2023-05-15 was added
  request-property-default-value-added
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value classification was added
  request-property-default-value-added
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value true was added
  request-property-default-value-added
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value text/generation was added
  request-property-default-value-added
- ○
  the request property default value openai was added
  request-property-default-value-added
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value false was added
  request-property-default-value-added
- ○
  the request property default value 8192 was added
  request-property-default-value-added
- ○
  the request property default value true was added
  request-property-default-value-added
- ○
  the request property default value grpc grpcs http https ws wss was added
  request-property-default-value-added
- ○
  the request property default value allow was added
  request-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value 2023-05-15 was added for the status
  response-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value classification was added for the status
  response-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value true was added for the status
  response-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value text/generation was added for the status
  response-property-default-value-added
- ○
  the response's property default value openai was added for the status
  response-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value false was added for the status
  response-property-default-value-added
- ○
  the response's property default value 8192 was added for the status
  response-property-default-value-added
- ○
  the response's property default value true was added for the status
  response-property-default-value-added
- ○
  the response's property default value grpc grpcs http https ws wss was added for the status
  response-property-default-value-added
- ○
  the response's property default value allow was added for the status
  response-property-default-value-added
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 22, 20252c77aeaee5fb51530See the full diff
- ▲
  the request property //// became required
  request-property-became-required
- ▲
  the request property ///// became required
  request-property-became-required
- ▲
  the request property ////// became required
  request-property-became-required
- ▲
  the request property ///// became required
  request-property-became-required
- ▲
  the response property //// became nullable for the status
  response-property-became-nullable
- ●
  added the new audio/v1/audio/speech enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new audio/v1/audio/transcriptions enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new audio/v1/audio/translations enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new cohere enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new huggingface enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new image/v1/images/edits enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new image/v1/images/generations enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new llm/v1/assistants enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new llm/v1/batches enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new llm/v1/embeddings enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new llm/v1/files enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new llm/v1/responses enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new realtime/v1/realtime enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new ws enum value to the ///// response property for the response status
  response-property-enum-value-added
- ●
  added the new wss enum value to the ///// response property for the response status
  response-property-enum-value-added
- ○
  added the new optional request property /////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ////////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  the request property //// became nullable
  request-property-became-nullable
- ○
  added the new audio/v1/audio/speech enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new audio/v1/audio/transcriptions enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new audio/v1/audio/translations enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new cohere enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new huggingface enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new image/v1/images/edits enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new image/v1/images/generations enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new llm/v1/assistants enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new llm/v1/batches enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new llm/v1/embeddings enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new llm/v1/files enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new llm/v1/responses enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new realtime/v1/realtime enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new ws enum value to the request property /////
  request-property-enum-value-added
- ○
  added the new wss enum value to the request property /////
  request-property-enum-value-added
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  the response property //// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ///// became required for the status
  response-property-became-required
Jun 17, 2025c308b7426a7c2See the full diff
- ▲
  the //// request property format changed from no format to set
  request-property-type-changed
- ▲
  the //// response's property format changed from no format to set for status
  response-property-type-changed

Full history (19 revisions)