# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Datadog Delete API version: 1.0.0 extends: openapi/datadog-delete-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 44 - target: $.paths['/api/v2/agentless_scanning/accounts/aws/{account_id}'].delete update: x-apievangelist-phrasing: intent: Remove Agentless scan options for an AWS account effect: destructive questions: - How do I stop Agentless scanning settings from applying to one AWS account? - Can I remove the Agentless scan options I set up for a specific AWS account? instructions: - text: Delete the Agentless scan options for AWS account {account_id}. slots: account_id: path.account_id - text: Turn off Agentless scanning configuration on AWS account {account_id}. slots: account_id: path.account_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/api_keys/{api_key_id}'].delete update: x-apievangelist-phrasing: intent: Delete an API key effect: destructive questions: - How do I permanently delete a Datadog API key that leaked? - Can I remove an organization API key I no longer use? instructions: - text: Delete API key {api_key_id}. slots: api_key_id: path.api_key_id - text: Remove the org API key with ID {api_key_id} so it stops working. slots: api_key_id: path.api_key_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/apicatalog/api/{id}'].delete update: x-apievangelist-phrasing: intent: Delete an API from the API catalog effect: destructive questions: - What's the way to remove an API definition from the API catalog? - Can I delete a cataloged API by its ID? instructions: - text: Delete API {id} from the API catalog. slots: id: path.id - text: Remove the catalog API entry {id}. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/apm/config/metrics/{metric_id}'].delete update: x-apievangelist-phrasing: intent: Delete a span-based metric effect: destructive questions: - How can I get rid of a metric I generated from APM spans? - Is it possible to delete a span-based metric by name? instructions: - text: Delete span-based metric {metric_id}. slots: metric_id: path.metric_id - text: Remove the APM span metric named {metric_id} from my org. slots: metric_id: path.metric_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/apm/config/retention-filters/{filter_id}'].delete update: x-apievangelist-phrasing: intent: Delete an APM span retention filter effect: destructive questions: - Can I delete an APM retention filter that keeps spans I no longer need? - Which APM retention filters are protected from deletion? instructions: - text: Delete APM retention filter {filter_id}. slots: filter_id: path.filter_id - text: Remove the span retention filter {filter_id} from my APM configuration. slots: filter_id: path.filter_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/authn_mappings/{authn_mapping_id}'].delete update: x-apievangelist-phrasing: intent: Delete an AuthN mapping effect: destructive questions: - How do I remove a SAML attribute-to-role AuthN mapping? - Can I delete an AuthN mapping using its UUID? instructions: - text: Delete AuthN mapping {authn_mapping_id}. slots: authn_mapping_id: path.authn_mapping_id - text: Remove the authentication mapping {authn_mapping_id}. slots: authn_mapping_id: path.authn_mapping_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/catalog/entity/{entity_id}'].delete update: x-apievangelist-phrasing: intent: Delete an entity from Software Catalog effect: destructive questions: - How can I remove a service or entity from the Software Catalog? - Can I delete a catalog entity using its entity reference instead of a UUID? instructions: - text: Delete Software Catalog entity {entity_id}. slots: entity_id: path.entity_id - text: Remove {entity_id} from the Software Catalog. slots: entity_id: path.entity_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/incidents/config/types/{incident_type_id}'].delete update: x-apievangelist-phrasing: intent: Delete an incident type effect: destructive questions: - Can I delete an incident type I configured but never use? - What's the way to remove an incident type from incident settings? instructions: - text: Delete incident type {incident_type_id}. slots: incident_type_id: path.incident_type_id - text: Remove the incident type configuration {incident_type_id}. slots: incident_type_id: path.incident_type_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/incidents/{incident_id}'].delete update: x-apievangelist-phrasing: intent: Delete an incident effect: destructive questions: - How do I delete an incident that was declared by mistake? - Can I permanently remove an incident from my organization? instructions: - text: Delete incident {incident_id}. slots: incident_id: path.incident_id - text: Remove the incident with UUID {incident_id} from my org. slots: incident_id: path.incident_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}'].delete update: x-apievangelist-phrasing: intent: Delete an incident's integration metadata effect: destructive questions: - Can I remove a linked integration record from an incident? - What happens if I delete integration metadata attached to an incident? instructions: - text: Delete integration metadata {integration_metadata_id} from incident {incident_id}. slots: integration_metadata_id: path.integration_metadata_id incident_id: path.incident_id - text: Unlink integration {integration_metadata_id} on incident {incident_id}. slots: integration_metadata_id: path.integration_metadata_id incident_id: path.incident_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/incidents/{incident_id}/relationships/todos/{todo_id}'].delete update: x-apievangelist-phrasing: intent: Delete a todo from an incident effect: destructive questions: - How do I remove a todo item from an incident? - Can I delete a single incident todo without touching the others? instructions: - text: Delete todo {todo_id} from incident {incident_id}. slots: todo_id: path.todo_id incident_id: path.incident_id - text: Remove the action item {todo_id} on incident {incident_id}. slots: todo_id: path.todo_id incident_id: path.incident_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/integration/aws/accounts/{aws_account_config_id}'].delete update: x-apievangelist-phrasing: intent: Delete an AWS account integration effect: destructive questions: - How do I disconnect an AWS account from Datadog's AWS integration? - Do I need the integration config ID rather than the AWS account number to remove it? instructions: - text: Delete the AWS integration config {aws_account_config_id}. slots: aws_account_config_id: path.aws_account_config_id - text: Disconnect the AWS account integration with config ID {aws_account_config_id}. slots: aws_account_config_id: path.aws_account_config_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/integration/ms-teams/configuration/tenant-based-handles/{handle_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Microsoft Teams tenant-based handle effect: destructive questions: - Can I remove a tenant-based handle from the Microsoft Teams integration? - How do I stop notifications going to a Teams channel handle tied to my tenant? instructions: - text: Delete Microsoft Teams tenant-based handle {handle_id}. slots: handle_id: path.handle_id - text: Remove the Teams tenant handle {handle_id}. slots: handle_id: path.handle_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/integration/ms-teams/configuration/workflows-webhook-handles/{handle_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Microsoft Teams Workflows webhook handle effect: destructive questions: - How do I remove a Workflows webhook handle from the Microsoft Teams integration? - Can I delete a Teams Workflows webhook handle I set up for alerts? instructions: - text: Delete Microsoft Teams Workflows webhook handle {handle_id}. slots: handle_id: path.handle_id - text: Remove the Teams Workflows webhook {handle_id}. slots: handle_id: path.handle_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/integration/opsgenie/services/{integration_service_id}'].delete update: x-apievangelist-phrasing: intent: Delete an Opsgenie integration service effect: destructive questions: - Can I remove a service object from the Opsgenie integration? - What's the way to stop routing to an Opsgenie service in Datadog? instructions: - text: Delete Opsgenie service {integration_service_id}. slots: integration_service_id: path.integration_service_id - text: Remove the Opsgenie integration service with UUID {integration_service_id}. slots: integration_service_id: path.integration_service_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/integrations/fastly/accounts/{account_id}/services/{service_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Fastly service from an account effect: destructive questions: - How do I stop monitoring a Fastly service under my Fastly account? - Can I remove one Fastly service without deleting the whole account? instructions: - text: Delete Fastly service {service_id} from Fastly account {account_id}. slots: service_id: path.service_id account_id: path.account_id - text: Remove service {service_id} under Fastly account {account_id}. slots: service_id: path.service_id account_id: path.account_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/logs/config/metrics/{metric_id}'].delete update: x-apievangelist-phrasing: intent: Delete a log-based metric effect: destructive questions: - How can I delete a metric I generated from logs? - Will deleting a log-based metric by name stop it from being computed? instructions: - text: Delete log-based metric {metric_id}. slots: metric_id: path.metric_id - text: Remove the metric {metric_id} that is generated from my logs. slots: metric_id: path.metric_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/logs/config/restriction_queries/{restriction_query_id}'].delete update: x-apievangelist-phrasing: intent: Delete a logs restriction query effect: destructive questions: - Can I delete a restriction query that limits which logs a role can see? - How do I remove a log data access restriction query? instructions: - text: Delete logs restriction query {restriction_query_id}. slots: restriction_query_id: path.restriction_query_id - text: Remove restriction query {restriction_query_id} entirely. slots: restriction_query_id: path.restriction_query_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/metrics/config/bulk-tags'].delete update: x-apievangelist-phrasing: intent: Delete tag configurations for metrics by prefix effect: destructive questions: - Can I clear queryable tag configurations for every metric that shares a name prefix? - Which metric types does bulk tag configuration deletion apply to? instructions: - text: Delete all custom tag configurations for metrics matching prefix {data}. slots: data: requestBody.data - text: Bulk remove queryable tag key lists for metrics under {data}. slots: data: requestBody.data method: generated generated: '2026-10-01' - target: $.paths['/api/v2/monitor/notification_rule/{rule_id}'].delete update: x-apievangelist-phrasing: intent: Delete a monitor notification rule effect: destructive questions: - How do I remove a monitor notification rule? - Can I delete a rule that routes monitor alerts to recipients? instructions: - text: Delete monitor notification rule {rule_id}. slots: rule_id: path.rule_id - text: Remove the monitor alert routing rule {rule_id}. slots: rule_id: path.rule_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/on-call/escalation-policies/{policy_id}'].delete update: x-apievangelist-phrasing: intent: Delete an On-Call escalation policy effect: destructive questions: - Can I delete an On-Call escalation policy we replaced? - What's the way to remove an escalation policy from On-Call? instructions: - text: Delete On-Call escalation policy {policy_id}. slots: policy_id: path.policy_id - text: Remove escalation policy {policy_id}. slots: policy_id: path.policy_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/on-call/schedules/{schedule_id}'].delete update: x-apievangelist-phrasing: intent: Delete an On-Call schedule effect: destructive questions: - How do I delete an On-Call rotation schedule? - Can I remove an On-Call schedule nobody is on anymore? instructions: - text: Delete On-Call schedule {schedule_id}. slots: schedule_id: path.schedule_id - text: Remove the on-call rotation schedule {schedule_id}. slots: schedule_id: path.schedule_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/powerpacks/{powerpack_id}'].delete update: x-apievangelist-phrasing: intent: Delete a powerpack effect: destructive questions: - Can I delete a dashboard powerpack template? - What's involved in removing a powerpack by its ID? instructions: - text: Delete powerpack {powerpack_id}. slots: powerpack_id: path.powerpack_id - text: Remove the reusable widget group powerpack {powerpack_id}. slots: powerpack_id: path.powerpack_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/remote_config/products/asm/waf/exclusion_filters/{exclusion_filter_id}'].delete update: x-apievangelist-phrasing: intent: Delete a WAF exclusion filter effect: destructive questions: - How do I delete a WAF exclusion filter in App and API Protection? - Can I remove an exclusion that stops the WAF from flagging certain traffic? instructions: - text: Delete WAF exclusion filter {exclusion_filter_id}. slots: exclusion_filter_id: path.exclusion_filter_id - text: Remove the WAF exclusion {exclusion_filter_id}. slots: exclusion_filter_id: path.exclusion_filter_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/remote_config/products/cws/policy/{policy_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Workload Protection policy effect: destructive questions: - How can I delete a Workload Protection agent policy? - Does deleting a Workload Protection policy work on the US1-FED site? instructions: - text: Delete Workload Protection policy {policy_id}. slots: policy_id: path.policy_id - text: Remove the Workload Protection agent policy {policy_id}. slots: policy_id: path.policy_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/remote_config/products/obs_pipelines/pipelines/{pipeline_id}'].delete update: x-apievangelist-phrasing: intent: Delete an Observability Pipeline effect: destructive questions: - Can I delete an Observability Pipelines configuration? - How do I remove a pipeline I no longer route data through? instructions: - text: Delete observability pipeline {pipeline_id}. slots: pipeline_id: path.pipeline_id - text: Remove pipeline {pipeline_id} from Observability Pipelines. slots: pipeline_id: path.pipeline_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/restriction_policy/{resource_id}'].delete update: x-apievangelist-phrasing: intent: Delete the restriction policy on a resource effect: destructive questions: - How do I remove the access restriction policy on a dashboard? - Which resource types can have their restriction policy deleted? instructions: - text: Delete the restriction policy on resource {resource_id}. slots: resource_id: path.resource_id - text: Remove access restrictions from {resource_id}. slots: resource_id: path.resource_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/roles/{role_id}'].delete update: x-apievangelist-phrasing: intent: Disable a role effect: destructive questions: - Can I disable a custom role in my organization? - What actually happens when I delete a role — is it disabled? instructions: - text: Disable role {role_id}. slots: role_id: path.role_id - text: Delete the role with identifier {role_id}. slots: role_id: path.role_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/rum/applications/{app_id}/retention_filters/{rf_id}'].delete update: x-apievangelist-phrasing: intent: Delete a RUM retention filter effect: destructive questions: - How do I delete a retention filter on a RUM application? - Can I remove one RUM retention filter without affecting the app's others? instructions: - text: Delete RUM retention filter {rf_id} on application {app_id}. slots: rf_id: path.rf_id app_id: path.app_id - text: Remove retention filter {rf_id} from RUM app {app_id}. slots: rf_id: path.rf_id app_id: path.app_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/rum/config/metrics/{metric_id}'].delete update: x-apievangelist-phrasing: intent: Delete a RUM-based metric effect: destructive questions: - Can I delete a metric generated from RUM events? - What's the way to remove a rum-based metric by name? instructions: - text: Delete RUM-based metric {metric_id}. slots: metric_id: path.metric_id - text: Remove the metric {metric_id} generated from RUM data. slots: metric_id: path.metric_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/scim/Groups/{group_id}'].delete update: x-apievangelist-phrasing: intent: Delete a SCIM group effect: destructive questions: - How do I delete a group provisioned through SCIM? - Can my identity provider remove a SCIM group by its ID? instructions: - text: Delete SCIM group {group_id}. slots: group_id: path.group_id - text: Deprovision the SCIM group {group_id}. slots: group_id: path.group_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/scim/Users/{user_uuid}'].delete update: x-apievangelist-phrasing: intent: Delete a SCIM user effect: destructive questions: - How do I deprovision a user through SCIM? - Can I delete a SCIM-provisioned user by UUID? instructions: - text: Delete SCIM user {user_uuid}. slots: user_uuid: path.user_uuid - text: Deprovision the SCIM user with UUID {user_uuid}. slots: user_uuid: path.user_uuid method: generated generated: '2026-10-01' - target: $.paths['/api/v2/scorecard/rules/{rule_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Scorecard rule effect: destructive questions: - Can I delete a Scorecard rule that grades my services? - What's the way to remove a single service scorecard rule? instructions: - text: Delete scorecard rule {rule_id}. slots: rule_id: path.rule_id - text: Remove the service Scorecard rule {rule_id}. slots: rule_id: path.rule_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/security/signals/notification_rules/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a security signal notification rule effect: destructive questions: - How do I delete a notification rule for security signals? - Can I stop a signal-based notification rule from alerting? instructions: - text: Delete security signal notification rule {id}. slots: id: path.id - text: Remove signal-based notification rule {id}. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/security/vulnerabilities/notification_rules/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a vulnerability notification rule effect: destructive questions: - Can I delete a notification rule for security vulnerabilities? - What's the way to stop vulnerability-based notifications from one rule? instructions: - text: Delete vulnerability notification rule {id}. slots: id: path.id - text: Remove the vulnerability-based notification rule {id}. slots: id: path.id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/security_monitoring/configuration/security_filters/{security_filter_id}'].delete update: x-apievangelist-phrasing: intent: Delete a security filter effect: destructive questions: - How do I delete a Cloud SIEM security filter? - Can I remove a security filter that excludes logs from analysis? instructions: - text: Delete security filter {security_filter_id}. slots: security_filter_id: path.security_filter_id - text: Remove the security monitoring filter {security_filter_id}. slots: security_filter_id: path.security_filter_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/security_monitoring/configuration/suppressions/{suppression_id}'].delete update: x-apievangelist-phrasing: intent: Delete a security suppression rule effect: destructive questions: - Can I delete a suppression rule so signals fire again? - What's the way to remove a security monitoring suppression? instructions: - text: Delete suppression rule {suppression_id}. slots: suppression_id: path.suppression_id - text: Remove the security signal suppression {suppression_id}. slots: suppression_id: path.suppression_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/security_monitoring/rules/{rule_id}'].delete update: x-apievangelist-phrasing: intent: Delete a security detection rule effect: destructive questions: - How do I delete a custom security detection rule? - Can default detection rules be deleted? instructions: - text: Delete security monitoring rule {rule_id}. slots: rule_id: path.rule_id - text: Remove the custom detection rule {rule_id}. slots: rule_id: path.rule_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/sensitive-data-scanner/config/groups/{group_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Sensitive Data Scanner group effect: destructive questions: - How do I delete a Sensitive Data Scanner scanning group? - Does deleting a scanning group require the API meta version payload? instructions: - text: Delete scanning group {group_id}. slots: group_id: path.group_id - text: Remove Sensitive Data Scanner group {group_id} with meta {meta}. slots: group_id: path.group_id meta: requestBody.meta method: generated generated: '2026-10-01' - target: $.paths['/api/v2/sensitive-data-scanner/config/rules/{rule_id}'].delete update: x-apievangelist-phrasing: intent: Delete a Sensitive Data Scanner rule effect: destructive questions: - Can I delete a single Sensitive Data Scanner rule? - What do I need to send to remove a scanning rule? instructions: - text: Delete scanning rule {rule_id}. slots: rule_id: path.rule_id - text: Remove Sensitive Data Scanner rule {rule_id} with meta {meta}. slots: rule_id: path.rule_id meta: requestBody.meta method: generated generated: '2026-10-01' - target: $.paths['/api/v2/services/{service_id}'].delete update: x-apievangelist-phrasing: intent: Delete an incident service effect: destructive questions: - How do I delete an incident service? - Can I remove a service used to tag incidents? instructions: - text: Delete incident service {service_id}. slots: service_id: path.service_id - text: Remove the incident management service {service_id}. slots: service_id: path.service_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/siem-historical-detections/jobs/{job_id}'].delete update: x-apievangelist-phrasing: intent: Delete a historical detection job effect: destructive questions: - Can I delete a historical detection job I already ran? - What's the way to remove a SIEM historical job by its ID? instructions: - text: Delete historical detection job {job_id}. slots: job_id: path.job_id - text: Remove the SIEM historical job {job_id}. slots: job_id: path.job_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/teams/{team_id}'].delete update: x-apievangelist-phrasing: intent: Delete an incident team effect: destructive questions: - How do I delete an incident team? - Can I remove a team that's only used for incident assignment? instructions: - text: Delete incident team {team_id}. slots: team_id: path.team_id - text: Remove the incident management team {team_id}. slots: team_id: path.team_id method: generated generated: '2026-10-01' - target: $.paths['/api/v2/workflows/{workflow_id}'].delete update: x-apievangelist-phrasing: intent: Delete a workflow effect: destructive questions: - How do I delete a Workflow Automation workflow? - Which application key permission is needed to delete a workflow? instructions: - text: Delete workflow {workflow_id}. slots: workflow_id: path.workflow_id - text: Remove the automation workflow {workflow_id}. slots: workflow_id: path.workflow_id method: generated generated: '2026-10-01'