---
title: "Delete a historical metrics configuration"
method: DELETE
path: "/api/v2/metrics/historical-metrics-configurations/{metric_name}"
tags: ["Metrics"]
---

# Delete a historical metrics configuration

`DELETE /api/v2/metrics/historical-metrics-configurations/{metric_name}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/metrics/historical-metrics-configurations/{metric_name}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `late_metrics_config_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/metrics/historical-metrics-configurations/:metric_name/delete.ts> (a function with typed inputs; its response is checked against the schema)

Disable historical metrics ingestion for a metric. Idempotent: always returns 204,
whether or not the configuration existed or the metric itself still exists, so that
Terraform destroy succeeds for a metric removed out-of-band.

## Path parameters

- `metric_name` string, required

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/c555647b183a?raw)