# Datadog APM Retention Filters API

**Canonical:** https://apis.io/apis/datadog-apm/datadog-apm-apm-retention-filters-api/  
**Provider:** Datadog APM — https://apis.io/providers/datadog-apm/  
**Base URL:** https://api.datadoghq.com  
**Documentation:** https://docs.datadoghq.com/api/latest/spans/

Datadog APM Retention Filters API is one of 8 APIs that [Datadog APM](https://apis.io/providers/datadog-apm/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include APM Retention Filters. The published artifact set on APIs.io includes an OpenAPI specification.

Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters) for your organization. You need an API and application key with Admin rights to interact with this endpoint. See [retention filters](https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/#retention-filters) on the Trace Retention page for more information.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/apm/config/retention-filters` | List all APM retention filters |
| POST | `/api/v2/apm/config/retention-filters` | Create a retention filter |
| PUT | `/api/v2/apm/config/retention-filters-execution-order` | Re-order retention filters |
| DELETE | `/api/v2/apm/config/retention-filters/{filter_id}` | Delete a retention filter |
| GET | `/api/v2/apm/config/retention-filters/{filter_id}` | Get a given APM retention filter |
| PUT | `/api/v2/apm/config/retention-filters/{filter_id}` | Update a retention filter |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/datadog-apm/refs/heads/main/openapi/datadog-apm-apm-retention-filters-api-openapi.yml

## Other Datadog APM APIs (7)

- [Datadog APM Spans API](https://apis.io/apis/datadog-apm/datadog-apm-spans-api/)
- [Datadog APM Spans Metrics API](https://apis.io/apis/datadog-apm/datadog-apm-spans-metrics-api/)
- [Datadog MCP Server](https://apis.io/apis/datadog-apm/datadog-apm-mcp-server/)
- [Datadog APM API](https://apis.io/apis/datadog-apm/datadog-apm-apm-api/)
- [Datadog APM Service Definition API](https://apis.io/apis/datadog-apm/datadog-apm-service-definition-api/)
- [Datadog APM Service Level Objective Corrections API](https://apis.io/apis/datadog-apm/datadog-apm-service-level-objective-corrections-api/)
- [Datadog APM Service Level Objectives API](https://apis.io/apis/datadog-apm/datadog-apm-service-level-objectives-api/)

## Tags

APM Retention Filters

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/datadog-apm/datadog-apm-apm-retention-filters-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/datadog-apm/.