---
title: "Changes to Create a AiSemanticCache plugin"
method: POST
path: "/v2/control-planes/{controlPlaneId}/core-entities/plugins#AiSemanticCache"
---

# Changes to Create a AiSemanticCache plugin

`POST /v2/control-planes/{controlPlaneId}/core-entities/plugins#AiSemanticCache`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 14 of 52 revisions.

- **2026-06-26** `4a39c7f85509` — 2 breaking, 2 info
- **2026-06-11** `62c54f1094bb` — 3 breaking, 3 info
- **2026-04-24** `7d6a643707d9` — 1 warning, 11 info
- **2026-01-13** `ad02b4e24eb2` — 2 breaking, 1 warning, 7 info
- **2025-10-29** `19e869275e28` — 4 breaking, 2 info
- **2025-09-16** `f03059016622` — 5 breaking
- **2025-08-22** `96118a9cd7f4` — 44 breaking, 124 info
- **2025-07-22** `2c77aeaee5fb` — 11 breaking, 2 warning, 17 info
- **2025-06-17** `c308b7426a7c` — 2 breaking
- **2025-05-21** `69704304ad5f` — 2 info
- **2025-05-01** `351c07039f3c` — 1 breaking, 5 warning, 16 info
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
- **2025-03-05** `ceb048468954` — 4 breaking, 4 info
- **2025-02-10** `d833d4dbb1fa` — 1 info

## Changes

- **2026-06-26** `4a39c7f85509` — 2 breaking, 2 info
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/port` request property type/format changed from `integer`/`` to `string`/``
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/port` response's property type/format changed from `integer`/`` to `string`/`` for status `201`
  - the `port` request property default value changed from `6379` to `6379`
  - the `port` response's property default value changed from `6379` to `6379` for the status `201`
- **2026-06-11** `62c54f1094bb` — 3 breaking, 3 info
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings` became optional for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb` became optional for the status `201`
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings` became optional
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb` became optional
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required for the status `201`
- **2026-04-24** `7d6a643707d9` — 1 warning, 11 info
  - added the new `ollama` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/gcp_metadata_url`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/gcp_oauth_token_url`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/batch_bucket_prefix`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/batch_role_arn`
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/condition`
  - added the new `ollama` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider`
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/gcp_metadata_url` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/gcp_oauth_token_url` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/batch_bucket_prefix` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/batch_role_arn` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/PluginBase]/condition` to the response with the `201` status
- **2026-01-13** `ad02b4e24eb2` — 2 breaking, 1 warning, 7 info
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became optional for the status `201`
  - added the new `anthropic` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/video_output_s3_uri`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/cloud_authentication`
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became nullable
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became optional
  - added the new `anthropic` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format`
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/video_output_s3_uri` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/cloud_authentication` to the response with the `201` status
- **2025-10-29** `19e869275e28` — 4 breaking, 2 info
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/name` request property type/format changed from `string`/`` to ``/``
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure` became optional for the status `201`
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/name` response's property type/format changed from `string`/`` to ``/`` for status `201`
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure` became nullable
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure` became optional
- **2025-09-16** `f03059016622` — 5 breaking
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/name` became not nullable
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became not nullable
  - the `allOf[#/components/schemas/PluginBase]/id` request property's minLength was increased from `0` to `1`
  - the `allOf[#/components/schemas/PluginBase]/name` request property's minLength was increased from `0` to `1`
  - the `allOf[#/components/schemas/PluginBase]/partials/items/id` request property's minLength was increased from `0` to `1`
- **2025-08-22** `96118a9cd7f4` — 44 breaking, 124 info
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/aws_access_key_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/aws_secret_access_key` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/azure_client_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/azure_client_secret` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/azure_tenant_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/gcp_service_account_json` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/header_name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/header_value` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/param_name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/auth/param_value` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure/deployment_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure/instance` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/aws_assume_role_arn` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/aws_region` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/aws_role_session_name` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/aws_sts_endpoint_url` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/performance_config_latency` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini/api_endpoint` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini/location_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini/project_id` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/huggingface` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/huggingface/use_cache` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/huggingface/wait_for_model` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/upstream_url` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector/password` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector/ssl_cert` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector/ssl_cert_key` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/cluster_nodes` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/keepalive_backlog` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/password` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/sentinel_master` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/sentinel_nodes` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/sentinel_password` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/redis/sentinel_username` became nullable for the status `201`
  - …128 more
- **2025-07-22** `2c77aeaee5fb` — 11 breaking, 2 warning, 17 info
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/name` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/dimensions` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/distance_metric` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/strategy` became required
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became required
  - the response property `allOf[#/components/schemas/PluginBase]/tags` became nullable for the status `201`
  - added the new `cohere` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format` response property for the response status `201`
  - added the new `huggingface` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/embeddings_normalize`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/performance_config_latency`
  - the request property `allOf[#/components/schemas/PluginBase]/tags` became nullable
  - added the new `cohere` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format`
  - added the new `huggingface` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format`
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/embeddings_normalize` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock/performance_config_latency` to the response with the `201` status
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/name` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/dimensions` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/distance_metric` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/strategy` became required for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/threshold` became required for the status `201`
- **2025-06-17** `c308b7426a7c` — 2 breaking
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/protocols` request property type/format changed from `array`/`` to `array`/`set`
  - the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/protocols` response's property type/format changed from `array`/`` to `array`/`set` for status `201`
- **2025-05-21** `69704304ad5f` — 2 info
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/partials`
  - added the optional property `allOf[#/components/schemas/PluginBase]/partials` to the response with the `201` status
- **2025-05-01** `351c07039f3c` — 1 breaking, 5 warning, 16 info
  - added the new required request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure`
  - added the new `azure` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` response property for the response status `201`
  - added the new `bedrock` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` response property for the response status `201`
  - added the new `gemini` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` response property for the response status `201`
  - added the new `huggingface` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider` response property for the response status `201`
  - added the new `pgvector` enum value to the `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/strategy` response property for the response status `201`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/huggingface`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format`
  - added the new optional request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector`
  - added the new `azure` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider`
  - added the new `bedrock` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider`
  - added the new `gemini` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider`
  - added the new `huggingface` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/provider`
  - added the new `pgvector` enum value to the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/strategy`
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/bedrock` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/gemini` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/huggingface` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/llm_format` to the response with the `201` status
  - added the optional property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/vectordb/pgvector` to the response with the `201` status
  - added the required property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/config/embeddings/model/options/azure` to the response with the `201` status
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
  - the response property `allOf[#/components/schemas/PluginBase]/created_at` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/PluginBase]/updated_at` became nullable for the status `201`
  - the request optional property `allOf[#/components/schemas/PluginBase]/created_at` became not read-only
  - the request optional property `allOf[#/components/schemas/PluginBase]/updated_at` became not read-only
  - the request property `allOf[#/components/schemas/PluginBase]/created_at` became nullable
  - the request property `allOf[#/components/schemas/PluginBase]/updated_at` became nullable
  - the response optional property `allOf[#/components/schemas/PluginBase]/created_at` became not read-only for the status `201`
  - the response optional property `allOf[#/components/schemas/PluginBase]/updated_at` became not read-only for the status `201`
- **2025-03-05** `ceb048468954` — 4 breaking, 4 info
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/consumer` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/consumer_group` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/route` became nullable for the status `201`
  - the response property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/service` became nullable for the status `201`
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/consumer` became nullable
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/consumer_group` became nullable
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/route` became nullable
  - the request property `allOf[#/components/schemas/AiSemanticCachePluginConfig]/service` became nullable
- **2025-02-10** `d833d4dbb1fa` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/control-planes/:controlPlaneId/core-entities/plugins#AiSemanticCache/post.md) · [API](https://skmtc.dev/kong/apis/konnect-api.md) · [Page](https://skmtc.dev/kong/apis/konnect-api/changes/v2/control-planes/:controlPlaneId/core-entities/plugins#AiSemanticCache/post)
