APIs / Datadog

Datadog API changes

Breaking changes, deprecations and new fields in the Datadog API, as they ship.

DatadogDatadog API v22026-10-18 · fdcea0287 additive

Additive
/api/v2/security_monitoring/batch-migrations added
No action needed.
/api/v2/security_monitoring/batch-migrations
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id} added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id}/cancel added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}/cancel
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id}/publish added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}/publish
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id}/resources added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}/resources
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id}/resources/{resource_id} added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}/resources/{resource_id}
Additive
/api/v2/security_monitoring/batch-migrations/{batch_id}/start added
No action needed.
/api/v2/security_monitoring/batch-migrations/{batch_id}/start

DatadogDatadog API v22026-10-16 · 9a5ed9f87 additive

Additive
/api/v2/usage/quotas/{quota_namespace}/{id}/pending added
No action needed.
/api/v2/usage/quotas/{quota_namespace}/{id}/pending

4 new response fields

UsageQuotaResponseAttributes.pending_effective_from
UsageQuotaResponseAttributes.pending_usage_limit
UsageQuotaBulkResultAttributes.pending_effective_from
UsageQuotaBulkResultAttributes.pending_usage_limit

2 new request properties

UsageQuotaCreateAttributes.pending_usage_limit
UsageQuotaUpdateAttributes.pending_usage_limit

DatadogDatadog API v22026-10-16 · 5be343041 additive

Additive
/api/v2/llm-obs/v1/topic-discovery-templates added
No action needed.
/api/v2/llm-obs/v1/topic-discovery-templates

DatadogDatadog API v22026-10-15 · 1ca9d7cc1 additive

Additive
/api/v2/team/{team_id}/members added
No action needed.
/api/v2/team/{team_id}/members

DatadogDatadog API v22026-10-15 · 85a9b21a1 additive

Additive
/api/v2/feature-flags/saved-filters/{saved_filter_id} added
No action needed.
/api/v2/feature-flags/saved-filters/{saved_filter_id}

DatadogDatadog API v22026-10-15 · 5096773b3 additive

Additive
POST /api/v2/org_group_memberships added
No action needed.
POST /api/v2/org_group_memberships
Additive
DELETE /api/v2/org_group_memberships/{org_group_membership_id} added
No action needed.
DELETE /api/v2/org_group_memberships/{org_group_membership_id}
Additive
/api/v2/org_group_memberships/bulk_delete added
No action needed.
/api/v2/org_group_memberships/bulk_delete

DatadogDatadog API v22026-10-14 · e021e11d1 behavioral24 additive

Behavioral
400 is now documented on /api/v2/feature-flags
An unhandled branch in your error handling.
GET /api/v2/feature-flags
Additive
created_by is now optional
No action needed.
GET /api/v2/feature-flags · created_by
Additive
distribution_channel is now optional
GET /api/v2/feature-flags · distribution_channel
Additive
flag_ids is now optional
GET /api/v2/feature-flags · flag_ids
Additive
page[limit] is now optional
GET /api/v2/feature-flags · page[limit]
Additive
page[offset] is now optional
GET /api/v2/feature-flags · page[offset]
Additive
production_status is now optional
GET /api/v2/feature-flags · production_status
Additive
saved_filter_id is now optional
GET /api/v2/feature-flags · saved_filter_id
Additive
search is now optional
GET /api/v2/feature-flags · search
Additive
sort is now optional
GET /api/v2/feature-flags · sort
Additive
staleness_status is now optional
GET /api/v2/feature-flags · staleness_status
Additive
tags is now optional
GET /api/v2/feature-flags · tags
Additive
teams is now optional
GET /api/v2/feature-flags · teams
Additive
value_type is now optional
GET /api/v2/feature-flags · value_type

11 new response fields

FeatureFlagAttributes.staleness_status_override
FeatureFlagsPaginationMetaPage.next_offset
FeatureFlagsPaginationMetaPage.prev_offset
FeatureFlagsPaginationMetaPage.total
FeatureFlagsPaginationMetaPage.type
ListFeatureFlagsResponse.links
FeatureFlagListItemAttributes.staleness_status_override
FeatureFlagsPaginationMetaPage.first_offset
FeatureFlagsPaginationMetaPage.last_offset
FeatureFlagsPaginationMetaPage.limit
FeatureFlagsPaginationMetaPage.offset

DatadogDatadog API v22026-10-14 · 15b2f5942 additive

Additive
Response field enabled_metric_aggregation added
No action needed unless you validate responses against a closed schema.
ObservabilityPipelineGenerateMetricsV2Processor.enabled_metric_aggregation · reachable from 5 operations
Additive
Request property enabled_metric_aggregation added
No action needed unless it is required.
ObservabilityPipelineGenerateMetricsV2Processor.enabled_metric_aggregation · reachable from 5 operations

DatadogDatadog API v22026-10-14 · 6152e8521 additive

Additive
debug_id is now optional
No action needed.
GET /api/v2/sourcemaps · debug_id

DatadogDatadog API v22026-10-13 · e6a6a05b3 additive

Additive
/api/v2/on-call/schedules/{schedule_id}/overrides added
No action needed.
/api/v2/on-call/schedules/{schedule_id}/overrides
Additive
/api/v2/on-call/schedules/{schedule_id}/overrides/{override_id} added
No action needed.
/api/v2/on-call/schedules/{schedule_id}/overrides/{override_id}
Additive
Response field color added
No action needed unless you validate responses against a closed schema.
ScheduleUserAttributes.color · reachable from 6 operations

DatadogDatadog API v22026-10-13 · 6bac05a42 behavioral

Behavioral
Status code no longer documented
Dead branch, or an undocumented response you still receive.
POST /api/v2/remote_config/products/cws/policy
Behavioral
201 is now documented on /api/v2/remote_config/products/cws/policy
An unhandled branch in your error handling.
POST /api/v2/remote_config/products/cws/policy

DatadogDatadog API v22026-10-13 · cf41ef1f6 additive

Additive
/api/v2/deployment_gates/evaluations added
No action needed.
/api/v2/deployment_gates/evaluations
Additive
filter[dry_run] is now optional
No action needed.
GET /api/v2/deployment_gates · filter[dry_run]
Additive
filter[env] is now optional
GET /api/v2/deployment_gates · filter[env]
Additive
filter[identifier] is now optional
GET /api/v2/deployment_gates · filter[identifier]
Additive
filter[service] is now optional
GET /api/v2/deployment_gates · filter[service]
Additive
/api/v2/deployment_gates/evaluations/rules added
No action needed.
/api/v2/deployment_gates/evaluations/rules

DatadogDatadog API v22026-10-12 · 66aa6eb91 behavioral4 additive

Behavioral
Default value changed
Behavior shifts for every call that omits the field.
GET /api/v2/sourcemaps/list · page[size]
Additive
page[after] is now optional
No action needed.
GET /api/v2/sourcemaps/list · page[after]
Additive
search_by is now optional
GET /api/v2/sourcemaps/list · search_by

2 new response fields

JSSourcemapAttributes.debug_id
SourcemapsListMetaPage.next_cursor

DatadogDatadog API v22026-10-09 · e076ae271 additive

Additive
/api/v2/security/findings/severity added
No action needed.
/api/v2/security/findings/severity

DatadogDatadog API v22026-10-08 · c8b4cfdf1 additive

Additive
Response field matched_params added
No action needed unless you validate responses against a closed schema.
RecommendationAttributes.matched_params · reachable from 3 operations

DatadogDatadog API v22026-10-08 · bb71914e1 breaking

Breaking
AuthZ no longer accepted on /api/v2/events
Callers using the withdrawn credentials are rejected. Callers already on a remaining option are unaffected.
POST /api/v2/events

DatadogDatadog API v22026-10-08 · 3287dede4 additive

Additive
/api/v2/cloud_auth/github/persona_mapping added
No action needed.
/api/v2/cloud_auth/github/persona_mapping
Additive
/api/v2/cloud_auth/github/intake_mapping added
No action needed.
/api/v2/cloud_auth/github/intake_mapping
Additive
/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} added
No action needed.
/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}
Additive
/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} added
No action needed.
/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}

DatadogDatadog API v22026-10-08 · 6fbc450f2 additive

Additive
Response field aggregation_timing added
No action needed unless you validate responses against a closed schema.
ObservabilityPipelineAggregateProcessor.aggregation_timing · reachable from 5 operations
Additive
Request property aggregation_timing added
No action needed unless it is required.
ObservabilityPipelineAggregateProcessor.aggregation_timing · reachable from 5 operations

DatadogDatadog API v22026-10-08 · 3b1fd0b31 additive

Additive
/api/v2/ai_impact/user_activity added
No action needed.
/api/v2/ai_impact/user_activity

DatadogDatadog API v22026-10-08 · 4e5853106 deprecation

Deprecation
POST /api/v2/integration/salesforce-incidents/incident-templates deprecated
Still works today. This is the earliest warning you will get before it is removed.
POST /api/v2/integration/salesforce-incidents/incident-templates
Deprecation
GET /api/v2/integration/salesforce-incidents/incident-templates deprecated
Still works today. This is the earliest warning you will get before it is removed.
GET /api/v2/integration/salesforce-incidents/incident-templates
Deprecation
DELETE /api/v2/integration/salesforce-incidents/incident-templates/{incident_template_id} deprecated
Still works today. This is the earliest warning you will get before it is removed.
DELETE /api/v2/integration/salesforce-incidents/incident-templates/{incident_template_id}
Deprecation
PATCH /api/v2/integration/salesforce-incidents/incident-templates/{incident_template_id} deprecated
Still works today. This is the earliest warning you will get before it is removed.
PATCH /api/v2/integration/salesforce-incidents/incident-templates/{incident_template_id}
Deprecation
GET /api/v2/integration/salesforce-incidents/organizations deprecated
Still works today. This is the earliest warning you will get before it is removed.
GET /api/v2/integration/salesforce-incidents/organizations
Deprecation
DELETE /api/v2/integration/salesforce-incidents/organizations/{salesforce_org_id} deprecated
Still works today. This is the earliest warning you will get before it is removed.
DELETE /api/v2/integration/salesforce-incidents/organizations/{salesforce_org_id}

DatadogDatadog API v22026-10-07 · 42b068711 additive

Additive
/api/v2/cost/cloud_accounts added
No action needed.
/api/v2/cost/cloud_accounts

DatadogDatadog API v22026-10-06 · 7ad62c2d1 additive

Additive
/api/v2/cilogs added
No action needed.
/api/v2/cilogs

DatadogDatadog API v22026-10-02 · 0b4bdc1a36 additive

Additive
/api/v2/experiments added
No action needed.
/api/v2/experiments
Additive
/api/v2/experiments/exposure-sql-models added
No action needed.
/api/v2/experiments/exposure-sql-models
Additive
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id} added
No action needed.
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id}
Additive
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id}/archive added
No action needed.
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id}/archive
Additive
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id}/unarchive added
No action needed.
/api/v2/experiments/exposure-sql-models/{exposure_sql_model_id}/unarchive
Additive
/api/v2/experiments/metric-collections added
No action needed.
/api/v2/experiments/metric-collections
Additive
/api/v2/experiments/metric-collections/{metric_collection_id} added
No action needed.
/api/v2/experiments/metric-collections/{metric_collection_id}
Additive
/api/v2/experiments/metric-sql-models added
No action needed.
/api/v2/experiments/metric-sql-models
Additive
/api/v2/experiments/metric-sql-models/{metric_sql_model_id} added
No action needed.
/api/v2/experiments/metric-sql-models/{metric_sql_model_id}
Additive
/api/v2/experiments/metrics added
No action needed.
/api/v2/experiments/metrics
Additive
/api/v2/experiments/metrics/{metric_id} added
No action needed.
/api/v2/experiments/metrics/{metric_id}
Additive
/api/v2/experiments/protocols/{protocol_id} added
No action needed.
/api/v2/experiments/protocols/{protocol_id}
Additive
/api/v2/experiments/results/refresh added
No action needed.
/api/v2/experiments/results/refresh
Additive
/api/v2/experiments/subject-types/{subject_type_id} added
No action needed.
/api/v2/experiments/subject-types/{subject_type_id}
Additive
/api/v2/experiments/subject-types/{subject_type_id}/default added
No action needed.
/api/v2/experiments/subject-types/{subject_type_id}/default
Additive
/api/v2/experiments/{experiment_id} added
No action needed.
/api/v2/experiments/{experiment_id}
Additive
/api/v2/experiments/{experiment_id}/analysis-plan added
No action needed.
/api/v2/experiments/{experiment_id}/analysis-plan
Additive
/api/v2/experiments/{experiment_id}/cancel added
No action needed.
/api/v2/experiments/{experiment_id}/cancel
Additive
/api/v2/experiments/{experiment_id}/diagnostics added
No action needed.
/api/v2/experiments/{experiment_id}/diagnostics
Additive
/api/v2/experiments/{experiment_id}/metric-groups added
No action needed.
/api/v2/experiments/{experiment_id}/metric-groups
Additive
/api/v2/experiments/protocols added
No action needed.
/api/v2/experiments/protocols
Additive
/api/v2/experiments/{experiment_id}/conclude added
No action needed.
/api/v2/experiments/{experiment_id}/conclude
Additive
/api/v2/experiments/subject-types added
No action needed.
/api/v2/experiments/subject-types
Additive
/api/v2/experiments/{experiment_id}/metric-groups/from-collection/{metric_collection_id} added
No action needed.
/api/v2/experiments/{experiment_id}/metric-groups/from-collection/{metric_collection_id}
Additive
/api/v2/experiments/{experiment_id}/metric-groups/{metric_group_id} added
No action needed.
/api/v2/experiments/{experiment_id}/metric-groups/{metric_group_id}
Additive
/api/v2/experiments/{experiment_id}/results added
No action needed.
/api/v2/experiments/{experiment_id}/results
Additive
/api/v2/experiments/{experiment_id}/results/refresh added
No action needed.
/api/v2/experiments/{experiment_id}/results/refresh
Additive
/api/v2/experiments/{experiment_id}/start added
No action needed.
/api/v2/experiments/{experiment_id}/start
Additive
/api/v2/experiments/{experiment_id}/traffic-summary added
No action needed.
/api/v2/experiments/{experiment_id}/traffic-summary

7 new response fields

FeatureFlagAttributes.is_favorite
FeatureFlagAttributes.staleness_details
FeatureFlagEnvironment.observe_full_evaluation_data
EnvironmentAttributes.observe_full_evaluation_data
FeatureFlagListItemAttributes.staleness_details
FeatureFlagListItemAttributes.is_favorite
FeatureFlagEnvironmentListItem.observe_full_evaluation_data

DatadogDatadog API v22026-10-02 · e22df04c1 additive

Additive
/api/v2/spa/recommendations-v2/{service} added
No action needed.
/api/v2/spa/recommendations-v2/{service}

DatadogDatadog API v22026-10-02 · 1680f11f2 additive

2 new response fields

SecurityMonitoringSignalRuleResponse.compatibleVersion
SecurityMonitoringStandardRuleResponse.compatibleVersion

DatadogDatadog API v22026-10-02 · b48dadef4 additive

2 new response fields

TeamNotificationRuleAttributes.servicenow
TeamNotificationRuleAttributesEmail.recipient_email

2 new request properties

TeamNotificationRuleAttributes.servicenow
TeamNotificationRuleAttributesEmail.recipient_email

DatadogDatadog API v22026-10-02 · cb78159e1 breaking

Breaking
/api/v2/rum/query/insight/aggregated_signals_problems removed
Requests to this path now 404.
/api/v2/rum/query/insight/aggregated_signals_problems
Code that breaks
```
// Was:
await client.request("GET", "/api/v2/rum/query/insight/aggregated_signals_problems");
// Now: 404
```

DatadogDatadog API v22026-10-01 · c50159c61 additive

Additive
Request property filter added
No action needed unless it is required.
RecommendationsFilterRequestDataAttributes.filter · reachable from 1 operation

DatadogDatadog API v22026-10-01 · 580ae0f52 additive

Additive
/api/v2/logs/archive_searches added
No action needed.
/api/v2/logs/archive_searches
Additive
/api/v2/logs/archive_searches/{archive_search_id} added
No action needed.
/api/v2/logs/archive_searches/{archive_search_id}

DatadogDatadog API v22026-10-01 · 45d4c7521 additive

Additive
Response field source added
No action needed unless you validate responses against a closed schema.
DataDeletionResponseItemAttributes.source · reachable from 3 operations

DatadogDatadog API v22026-10-01 · 9bb89b0f1 additive

Additive
Response field meta added
No action needed unless you validate responses against a closed schema.
TableRowResourceArray.meta · reachable from 1 operation

DatadogDatadog API v22026-09-30 · 6777f9be4 additive

2 new response fields

RoleCreateAttributes.default_permissions_opt_out
RoleUpdateAttributes.default_permissions_opt_out

2 new request properties

RoleCreateAttributes.default_permissions_opt_out
RoleUpdateAttributes.default_permissions_opt_out

DatadogDatadog API v22026-09-30 · 610616ee2 additive

Additive
entity_type is now optional
No action needed.
GET /api/v2/security_monitoring/entity_context · entity_type · 2 call sites
Additive
/api/v2/security_monitoring/entity_context/recently_updated added
No action needed.
/api/v2/security_monitoring/entity_context/recently_updated

DatadogDatadog API v22026-09-28 · 67ed08e81 breaking

Breaking
New scope required on /api/v2/ddsql/query/tabular
Existing tokens 403. This needs user re-consent, not a code change, so it cannot be fixed by deploying.
POST /api/v2/ddsql/query/tabular · 2 call sites

DatadogDatadog API v22026-09-28 · e12c8ddd9 additive

Additive
include is now optional
No action needed.
GET /api/v2/personal_access_tokens · include · 4 call sites
Additive
filter[leaked] is now optional
GET /api/v2/personal_access_tokens · filter[leaked] · 2 call sites

7 new response fields

ServiceAccessTokenRelationships.leak_information
ListPersonalAccessTokensResponse.included
ListServiceAccessTokensResponse.included
PersonalAccessTokenRelationships.leak_information
PersonalAccessTokenResponse.included
AccessTokenListItemRelationships.leak_information
ServiceAccessTokenResponse.included

DatadogDatadog API v22026-09-25 · 490f55d71 behavioral

Behavioral
409 is now documented on /api/v2/org/disable
An unhandled branch in your error handling.
POST /api/v2/org/disable

DatadogDatadog API v22026-09-25 · e6815a341 additive

Additive
Request property general_investigation added
No action needed unless it is required.
TriggerAttributes.general_investigation · reachable from 1 operation

DatadogDatadog API v22026-09-24 · c8d3f3f41 additive

Additive
Request property id added
No action needed unless it is required.
TeamRoutingRulesRequestRule.id · reachable from 1 operation

DatadogDatadog API v22026-09-24 · f4b6fc1b1 additive

Additive
Response field authoring_template added
No action needed unless you validate responses against a closed schema.
LLMObsPromptVersionDataAttributes.authoring_template · reachable from 3 operations

DatadogDatadog API v22026-09-24 · 7f87545b4 additive

2 new response fields

LLMObsPromptVersionDataAttributes.config
LLMObsPromptSDKDataAttributes.config

2 new request properties

LLMObsCreatePromptDataAttributes.config
LLMObsCreatePromptVersionDataAttributes.config

DatadogDatadog API v22026-09-23 · 6db6abd32 additive

Additive
/api/v2/integration-interfaces/databricks/accounts added
No action needed.
/api/v2/integration-interfaces/databricks/accounts
Additive
/api/v2/integration-interfaces/databricks/accounts/{account_id} added
No action needed.
/api/v2/integration-interfaces/databricks/accounts/{account_id}

DatadogDatadog API v22026-09-23 · 38bc164f1 breaking

Breaking
New scope required on /api/v2/bits-ai/investigations
Existing tokens 403. This needs user re-consent, not a code change, so it cannot be fixed by deploying.
POST /api/v2/bits-ai/investigations

DatadogDatadog API v22026-09-22 · 6a82c06f2 additive

2 new response fields

FullAPIKeyAttributes.private_action_runner_enroll_enabled
PartialAPIKeyAttributes.private_action_runner_enroll_enabled

DatadogDatadog API v22026-09-22 · 53e5953b1 deprecation

Deprecation
POST /api/v2/incidents/{incident_id}/cases/page deprecated
Still works today. This is the earliest warning you will get before it is removed.
POST /api/v2/incidents/{incident_id}/cases/page