Plugins

Update a Datadog plugin

Update a Datadog plugin

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

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'datadog' 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 set of strings representing protocols.

Response

Datadog 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'datadog' 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 set of strings representing protocols.

Changes

Changed in 16 of the 52 revisions of this API.362101

Jun 11, 202662c54f1094bb11See the full diff
- ▲
  the request property allOf[PluginBase]/partials/items/path became required
  request-property-became-required
- ○
  the response property allOf[PluginBase]/partials/items/path became required for the status 200
  response-property-became-required
Apr 24, 20267d6a643707d92See the full diff
- ○
  added the new optional request property allOf[PluginBase]/condition
  new-optional-request-property
- ○
  added the optional property allOf[PluginBase]/condition to the response with the 200 status
  response-optional-property-added
Jan 13, 2026ad02b4e24eb22See the full diff
- ○
  added the new optional request property allOf[DatadogPluginConfig]/config/route_name_tag
  new-optional-request-property
- ○
  added the optional property allOf[DatadogPluginConfig]/config/route_name_tag to the response with the 200 status
  response-optional-property-added
Oct 29, 202519e869275e2822See the full diff
- ▲
  the allOf[DatadogPluginConfig]/name request property type/format changed from string/ to /
  request-property-type-changed
- ▲
  the allOf[DatadogPluginConfig]/name response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  removed the pattern ^.*[^:]$ from the request property allOf[DatadogPluginConfig]/config/metrics/items/tags/items/
  request-property-pattern-removed
- ○
  the allOf[DatadogPluginConfig]/config/metrics/items/tags/items/ response's property pattern ^.*[^:]$ was removed for the status 200
  response-property-pattern-removed
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 16, 2025f0305901662284See the full diff
- ▲
  the request property allOf[DatadogPluginConfig]/config/metrics/items/sample_rate became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[DatadogPluginConfig]/config/metrics/items/tags became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[DatadogPluginConfig]/config/queue became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[PluginBase]/partials/items/name became not nullable
  request-property-became-not-nullable
- ▲
  the request property allOf[PluginBase]/partials/items/path became not nullable
  request-property-became-not-nullable
- ▲
  the allOf[PluginBase]/id request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the allOf[PluginBase]/name request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the allOf[PluginBase]/partials/items/id request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ○
  the initial_retry_delay request property default value 0.01 was removed
  request-property-default-value-removed
- ○
  the metrics request property default value {"consumer_identifier":"custom_id","name":"kong_latency","sample_rate":1,"stat_type":"timer","tags":["app:kong"]} was removed
  request-property-default-value-removed
- ○
  the initial_retry_delay response's property default value 0.01 was removed for the status 200
  response-property-default-value-removed
- ○
  the metrics response's property default value {"consumer_identifier":"custom_id","name":"kong_latency","sample_rate":1,"stat_type":"timer","tags":["app:kong"]} was removed for the status 200
  response-property-default-value-removed
Aug 22, 202596118a9cd7f41042See the full diff
- ▲
  the response property allOf[DatadogPluginConfig]/config became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/flush_timeout became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/metrics/items/sample_rate became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/metrics/items/tags became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/queue became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/queue/max_bytes became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/queue_size became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[DatadogPluginConfig]/config/retry_count became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[PluginBase]/partials/items/name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[PluginBase]/partials/items/path became nullable for the status 200
  response-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/flush_timeout became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/metrics/items/sample_rate became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/metrics/items/tags became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/queue became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/queue/max_bytes became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/queue_size became nullable
  request-property-became-nullable
- ○
  the request property allOf[DatadogPluginConfig]/config/retry_count became nullable
  request-property-became-nullable
- ○
  the request property allOf[PluginBase]/partials/items/name became nullable
  request-property-became-nullable
- ○
  the request property allOf[PluginBase]/partials/items/path became nullable
  request-property-became-nullable
- ○
  the concurrency_limit request property default value 1 was added
  request-property-default-value-added
- ○
  the consumer_tag request property default value consumer was added
  request-property-default-value-added
- ○
  the enabled request property default value true was added
  request-property-default-value-added
- ○
  the host request property default value localhost was added
  request-property-default-value-added
- ○
  the initial_retry_delay request property default value 0.01 was added
  request-property-default-value-added
- ○
  the max_batch_size request property default value 1 was added
  request-property-default-value-added
- ○
  the max_coalescing_delay request property default value 1 was added
  request-property-default-value-added
- ○
  the max_entries request property default value 10000 was added
  request-property-default-value-added
- ○
  the max_retry_delay request property default value 60 was added
  request-property-default-value-added
- ○
  the max_retry_time request property default value 60 was added
  request-property-default-value-added
- ○
  the metrics request property default value {"consumer_identifier":"custom_id","name":"kong_latency","sample_rate":1,"stat_type":"timer","tags":["app:kong"]} was added
  request-property-default-value-added
- ○
  the port request property default value 8125 was added
  request-property-default-value-added
- ○
  the prefix request property default value kong was added
  request-property-default-value-added
- ○
  the protocols request property default value grpc grpcs http https was added
  request-property-default-value-added
- ○
  the service_name_tag request property default value name was added
  request-property-default-value-added
- ○
  the status_tag request property default value status was added
  request-property-default-value-added
- ○
  the concurrency_limit response's property default value 1 was added for the status 200
  response-property-default-value-added
- ○
  the consumer_tag response's property default value consumer was added for the status 200
  response-property-default-value-added
- ○
  the enabled response's property default value true was added for the status 200
  response-property-default-value-added
- ○
  the host response's property default value localhost was added for the status 200
  response-property-default-value-added
- ○
  the initial_retry_delay response's property default value 0.01 was added for the status 200
  response-property-default-value-added
- ○
  the max_batch_size response's property default value 1 was added for the status 200
  response-property-default-value-added
- ○
  the max_coalescing_delay response's property default value 1 was added for the status 200
  response-property-default-value-added
- ○
  the max_entries response's property default value 10000 was added for the status 200
  response-property-default-value-added
- ○
  the max_retry_delay response's property default value 60 was added for the status 200
  response-property-default-value-added
- ○
  the max_retry_time response's property default value 60 was added for the status 200
  response-property-default-value-added
- ○
  the metrics response's property default value {"consumer_identifier":"custom_id","name":"kong_latency","sample_rate":1,"stat_type":"timer","tags":["app:kong"]} was added for the status 200
  response-property-default-value-added
- ○
  the port response's property default value 8125 was added for the status 200
  response-property-default-value-added
- ○
  the prefix response's property default value kong was added for the status 200
  response-property-default-value-added
- ○
  the protocols response's property default value grpc grpcs http https was added for the status 200
  response-property-default-value-added
- ○
  the service_name_tag response's property default value name was added for the status 200
  response-property-default-value-added
- ○
  the status_tag response's property default value status was added for the status 200
  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, 20252c77aeaee5fb11See the full diff
- ▲
  the response property allOf[PluginBase]/tags became nullable for the status 200
  response-property-became-nullable
- ○
  the request property allOf[PluginBase]/tags became nullable
  request-property-became-nullable
Jun 17, 2025c308b7426a7c2See the full diff
- ▲
  the allOf[DatadogPluginConfig]/protocols request property type/format changed from array/ to array/set
  request-property-type-changed
- ▲
  the allOf[DatadogPluginConfig]/protocols response's property type/format changed from array/ to array/set for status 200
  response-property-type-changed
May 21, 202569704304ad5f2See the full diff
- ○
  added the new optional request property allOf[PluginBase]/partials
  new-optional-request-property
- ○
  added the optional property allOf[PluginBase]/partials to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 15, 2025fc6abbc537f326See the full diff
- ▲
  the response property allOf[PluginBase]/created_at became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property allOf[PluginBase]/updated_at became nullable for the status 200
  response-property-became-nullable
- ○
  the request optional property allOf[PluginBase]/created_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request optional property allOf[PluginBase]/updated_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request property allOf[PluginBase]/created_at became nullable
  request-property-became-nullable
- ○
  the request property allOf[PluginBase]/updated_at became nullable
  request-property-became-nullable
- ○
  the response optional property allOf[PluginBase]/created_at became not read-only for the status 200
  response-optional-property-became-not-read-only
- ○
  the response optional property allOf[PluginBase]/updated_at became not read-only for the status 200
  response-optional-property-became-not-read-only
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history (16 revisions)