# Datadog APM Service Definition API

**Canonical:** https://apis.io/apis/datadog-apm/datadog-apm-service-definition-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 Service Definition 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 Service Definition. The published artifact set on APIs.io includes an OpenAPI specification.

API to create, update, retrieve and delete service definitions. Note: Service Catalog [v3.0 schema](https://docs.datadoghq.com/service_catalog/service_definitions/v3-0/) has new API endpoints documented under [Software Catalog](https://docs.datadoghq.com/api/latest/software-catalog/). Use the following Service Definition endpoints for v2.2 and earlier.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/services/definitions` | Get all service definitions |
| POST | `/api/v2/services/definitions` | Create or update service definition |
| DELETE | `/api/v2/services/definitions/{service_name}` | Delete a single service definition |
| GET | `/api/v2/services/definitions/{service_name}` | Get a single service definition |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/datadog-apm/refs/heads/main/openapi/datadog-apm-service-definition-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 Retention Filters API](https://apis.io/apis/datadog-apm/datadog-apm-apm-retention-filters-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

Service Definition

---

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