---
title: "Changes to Update a Opentelemetry plugin"
method: PUT
path: "/v2/control-planes/{controlPlaneId}/core-entities/plugins/{PluginId}#Opentelemetry"
---

# Changes to Update a Opentelemetry plugin

`PUT /v2/control-planes/{controlPlaneId}/core-entities/plugins/{PluginId}#Opentelemetry`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 19 of 52 revisions.

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

## Changes

- **2026-06-26** `4a39c7f85509` — 1 breaking, 2 info
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs_endpoint` became not nullable
  - request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs_endpoint` deprecated
  - response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs_endpoint` deprecated
- **2026-06-11** `62c54f1094bb` — 1 breaking, 1 info
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/path` became required for the status `200`
- **2026-04-24** `7d6a643707d9` — 6 info
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/metrics/enable_ai_metrics`
  - added the new optional request property `allOf[#/components/schemas/PluginBase]/condition`
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/metrics/enable_ai_metrics` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/PluginBase]/condition` to the response with the `200` status
- **2026-01-13** `ad02b4e24eb2` — 6 warning, 10 info
  - added the new `tcp` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new `tls` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new `tls_passthrough` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new `udp` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new `ws` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new `wss` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/` response property for the response status `200`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs_endpoint`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/metrics`
  - added the new `tcp` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the new `tls` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the new `tls_passthrough` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the new `udp` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the new `ws` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the new `wss` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols/items/`
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/access_logs_endpoint` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/metrics` to the response with the `200` status
- **2025-10-29** `19e869275e28` — 2 breaking
  - the `allOf[#/components/schemas/OpentelemetryPluginConfig]/name` request property type changed from `string` to no type
  - the `allOf[#/components/schemas/OpentelemetryPluginConfig]/name` response's property type changed from `string` to no type for status `200`
- **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` — 13 breaking, 45 info
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/batch_flush_delay` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/batch_span_count` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/headers` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/http_response_header_for_traceid` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/logs_endpoint` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/clear` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/extract` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/inject` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/queue/max_bytes` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/sampling_rate` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/traces_endpoint` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/name` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/PluginBase]/partials/items/path` became nullable for the status `200`
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/batch_flush_delay` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/batch_span_count` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/headers` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/http_response_header_for_traceid` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/logs_endpoint` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/clear` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/extract` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/inject` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/queue/max_bytes` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/sampling_rate` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/traces_endpoint` became nullable
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/name` became nullable
  - the request property `allOf[#/components/schemas/PluginBase]/partials/items/path` became nullable
  - the `concurrency_limit` request property default value `1` was added
  - the `connect_timeout` request property default value `1000` was added
  - the `default_format` request property default value `w3c` was added
  - the `enabled` request property default value `true` was added
  - the `header_type` request property default value `preserve` was added
  - the `max_batch_size` request property default value `200` was added
  - the `max_coalescing_delay` request property default value `1` was added
  - the `max_entries` request property default value `10000` was added
  - the `max_retry_delay` request property default value `60` was added
  - the `max_retry_time` request property default value `60` was added
  - the `propagation` request property default value `{"default_format":"w3c"}` was added
  - the `protocols` request property default value `grpc, grpcs, http, https` was added
  - the `queue` request property default value `{"max_batch_size":200}` was added
  - the `read_timeout` request property default value `5000` was added
  - …18 more
- **2025-08-12** `9ca62eba4eca` — 1 breaking, 1 info
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/default_format` became optional for the status `200`
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/default_format` became optional
- **2025-07-22** `2c77aeaee5fb` — 1 breaking, 3 info
  - the response property `allOf[#/components/schemas/PluginBase]/tags` became nullable for the status `200`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/sampling_strategy`
  - the request property `allOf[#/components/schemas/PluginBase]/tags` became nullable
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/sampling_strategy` to the response with the `200` status
- **2025-06-17** `c308b7426a7c` — 2 breaking
  - the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols` request property format changed from no format to `set`
  - the `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols` response's property format changed from no format to `set` for status `200`
- **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 `200` status
- **2025-05-01** `351c07039f3c` — 4 warning, 4 info
  - added the new `instana` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/header_type` response property for the response status `200`
  - added the new `instana` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/default_format` response property for the response status `200`
  - added the new `instana` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/extract/items/` response property for the response status `200`
  - added the new `instana` enum value to the `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/inject/items/` response property for the response status `200`
  - added the new `instana` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/header_type`
  - added the new `instana` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/default_format`
  - added the new `instana` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/extract/items/`
  - added the new `instana` enum value to the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/propagation/inject/items/`
- **2025-04-15** `fc6abbc537f3` — 2 breaking, 6 info
  - the response property `allOf[#/components/schemas/PluginBase]/created_at` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/PluginBase]/updated_at` became nullable for the status `200`
  - 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 `200`
  - the response optional property `allOf[#/components/schemas/PluginBase]/updated_at` became not read-only for the status `200`
- **2025-03-05** `ceb048468954` — 3 breaking, 3 info
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/consumer` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/route` became nullable for the status `200`
  - the response property `allOf[#/components/schemas/OpentelemetryPluginConfig]/service` became nullable for the status `200`
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/consumer` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/route` became nullable
  - the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/service` became nullable
- **2025-02-10** `d833d4dbb1fa` — 1 breaking, 1 warning, 10 info
  - added `#/components/schemas/PluginBase` to the request body `allOf` list
  - removed `#/components/schemas/Plugin` from the request body `allOf` list
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/consumer`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/route`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/service`
  - added `#/components/schemas/PluginBase` to the response body `allOf` list for the response status `200`
  - removed `#/components/schemas/Plugin` from the response body `allOf` list for the response status `200`
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/consumer` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/protocols` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/route` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/service` to the response with the `200` status
- **2024-12-13** `8aedc289a938` — 1 breaking
  - request body became required
- **2024-12-06** `426663331655` — 1 breaking
  - the request property `allOf[#/components/schemas/Plugin]/tags` became not nullable
- **2024-11-11** `08ead66e9ebb` — 4 breaking, 1 warning, 25 info
  - added the new required request property `allOf[#/components/schemas/Plugin]/config`
  - added the new required request property `allOf[#/components/schemas/Plugin]/name`
  - the `allOf[#/components/schemas/Plugin]/` request property type changed from no type to `object`
  - the `allOf[#/components/schemas/Plugin]/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/PluginWithoutParents, subschema #2` from the `allOf[#/components/schemas/Plugin]/` request property `allOf` list
  - added the new optional request property `allOf[#/components/schemas/Plugin]/consumer`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/consumer_group`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/enabled`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/id`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/instance_name`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/ordering`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/protocols`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/route`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/service`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/tags`
  - added the optional property `allOf[#/components/schemas/Plugin]/consumer` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/consumer_group` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/created_at` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/enabled` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/id` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/instance_name` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/ordering` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/protocols` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/route` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/service` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/tags` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/updated_at` to the response with the `200` status
  - removed `#/components/schemas/PluginWithoutParents, subschema #2` from the `allOf[#/components/schemas/Plugin]/` response property `allOf` list for the response status `200`
  - added the required property `allOf[#/components/schemas/Plugin]/config` to the response with the `200` status
  - added the required property `allOf[#/components/schemas/Plugin]/name` to the response with the `200` status
- **2024-09-11** `be7c36317ba6` — 2 warning, 8 info
  - removed the request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/endpoint`
  - removed the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/endpoint` from the response with the `200` status
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/logs_endpoint`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/queue/concurrency_limit`
  - added the new optional request property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/traces_endpoint`
  - added the new optional request property `allOf[#/components/schemas/Plugin]/allOf[#/components/schemas/PluginWithoutParents]/ordering`
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/logs_endpoint` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/queue/concurrency_limit` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/OpentelemetryPluginConfig]/config/traces_endpoint` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/Plugin]/allOf[#/components/schemas/PluginWithoutParents]/ordering` to the response with the `200` status

---

[Operation](https://skmtc.dev/kong/apis/konnect-api/docs/v2/control-planes/:controlPlaneId/core-entities/plugins/:PluginId#Opentelemetry/put.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/:PluginId#Opentelemetry/put)
