How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Datadog Single API

The Single API from Datadog — 3 operation(s) for single.

Datadog Single API is one of 290 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Single. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.

This API exposes 6 operations across 3 paths, and defines 66 schemas. It is described by OpenAPI 3.0.0, at version 1.0.

Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.

6 operations 3 paths 66 schemas 3 DELETE2 GET1 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0
Base URL
https://api.datadoghq.com
Authentication
OAuth 2.0, API Key, API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 4

Datadog Single API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes. An API key is passed in the header as DD-API-KEY (apiKeyAuth). An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth). It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • AuthZ — This API uses OAuth 2 with the implicit grant flow.
  • apiKeyAuth — Your Datadog API Key.
  • appKeyAuth — Your Datadog APP Key.

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 3 DELETE, 2 GET, 1 PATCH. Each is listed below with its method, path, parameters, and response codes.

Single 6
DELETE
/api/v2/catalog/entity/{entity_id}
Datadog Delete a Single Entity
DeleteCatalogEntity 1 param → 204400403404429
DELETE
/api/v2/integration/opsgenie/services/{integration_service_id}
Datadog Delete a Single Service Object
DeleteOpsgenieService 1 param → 204400403404429
GET
/api/v2/integration/opsgenie/services/{integration_service_id}
Datadog Get a Single Service Object
GetOpsgenieService 1 param → 200400403404409429
PATCH
/api/v2/integration/opsgenie/services/{integration_service_id}
Datadog Update a Single Service Object
UpdateOpsgenieService 1 param body → 200400403404409429
DELETE
/api/v2/services/definitions/{service_name}
Datadog Delete a Single Service Definition
DeleteServiceDefinition 1 param → 204400403404429
GET
/api/v2/services/definitions/{service_name}
Datadog Get a Single Service Definition
GetServiceDefinition 2 params → 200400403404409429

Schemas 66

The contract defines 66 schemas that model the data the API accepts and returns. The most detailed are ServiceDefinitionV2Dot2 (15 properties), ServiceDefinitionV2Dot1 (12 properties), ServiceDefinitionV2 (11 properties), ServiceDefinitionV1 (8 properties). Each schema is shown below with its type and property counts.

ServiceDefinitionV2
object
Service definition V2 for providing service metadata and integrations.
11 properties 2 required
ServiceDefinitionV2Dot2Version
string
Schema version being used.
ServiceDefinitionV1Version
string
Schema version being used.
OpsgenieServiceResponseAttributes
object
The attributes from an Opsgenie service response.
3 properties
ServiceDefinitionV2Dot1Pagerduty
object
PagerDuty integration for the service.
1 property
OpsgenieServiceUpdateAttributes
object
The Opsgenie service attributes for an update request.
4 properties
ServiceDefinitionV1Org
object
Org related information about the service.
2 properties
ServiceDefinitionV1ResourceType
string
Link type.
ServiceDefinitionV2Dot1Contact
Service owner's contacts information.
ServiceDefinitionV2Opsgenie
object
Opsgenie integration for the service.
2 properties 1 required
OpsgenieServiceRegionType
string
The region for the Opsgenie service.
ServiceDefinitionV2Dot1EmailType
string
Contact type.
ServiceDefinitionV2Dot1Version
string
Schema version being used.
ServiceDefinitionV2Dot2Opsgenie
object
Opsgenie integration for the service.
2 properties 1 required
ServiceDefinitionV2Dot1MSTeamsType
string
Contact type.
ServiceDefinitionV2Dot1LinkType
string
Link type.
ServiceDefinitionV2Dot2Contact
object
Service owner's contacts information.
3 properties 2 required
ServiceDefinitionV2Dot1
object
Service definition v2.1 for providing service metadata and integrations.
12 properties 2 required
ServiceDefinitionSchema
Service definition schema.
ServiceDefinitionSchemaVersions
string
Schema versions
ServiceDefinitionV2Dot1SlackType
string
Contact type.
ServiceDefinitionV2Integrations
object
Third party integrations that Datadog supports.
2 properties
ServiceDefinitionMeta
object
Metadata about a service definition.
7 properties
APIErrorResponse
object
API error response.
1 property 1 required
ServiceDefinitionV2Dot1Email
object
Service owner's email.
3 properties 2 required
OpsgenieServiceUpdateRequest
object
Update request for an Opsgenie service.
1 property 1 required
ServiceDefinitionV2Doc
object
Service documents.
3 properties 2 required
ServiceDefinitionV2Dot2Link
object
Service's external links.
4 properties 3 required
ServiceDefinitionV2Dot2Type
string
The type of service.
ServiceDefinitionV1Contact
object
Contact information about the service.
2 properties
ServiceDefinitionV2Dot2Integrations
object
Third party integrations that Datadog supports.
2 properties
ServiceDefinitionV2Contact
Service owner's contacts information.
OpsgenieServiceUpdateData
object
Opsgenie service for an update request.
3 properties 3 required
ServiceDefinitionV2Dot2OpsgenieRegion
string
Opsgenie instance region.
ServiceDefinitionV2Version
string
Schema version being used.
ServiceDefinitionV2LinkType
string
Link type.
ServiceDefinitionV2Dot1Link
object
Service's external links.
4 properties 3 required
ServiceDefinitionV2EmailType
string
Contact type.
ServiceDefinitionMetaWarnings
object
Schema validation warnings.
3 properties
ServiceDefinitionV2Dot1OpsgenieRegion
string
Opsgenie instance region.
ServiceDefinitionV2Slack
object
Service owner's Slack channel.
3 properties 2 required
ServiceDefinitionV2Dot1Integrations
object
Third party integrations that Datadog supports.
2 properties
OpsgenieServiceResponse
object
Response of an Opsgenie service.
1 property 1 required
ServiceDefinitionV2Repo
object
Service code repositories.
3 properties 2 required
ServiceDefinitionV1Resource
object
Service's external links.
3 properties 3 required
ServiceDefinitionData
object
Service definition data.
3 properties
ServiceDefinitionV2Dot1Opsgenie
object
Opsgenie integration for the service.
2 properties 1 required
ServiceDefinitionDataAttributes
object
Service definition attributes.
2 properties
ServiceDefinitionV2MSTeams
object
Service owner's Microsoft Teams.
3 properties 2 required
ServiceDefinitionV2Dot1Slack
object
Service owner's Slack channel.
3 properties 2 required
ServiceDefinitionV2Email
object
Service owner's email.
3 properties 2 required
OpsgenieServiceResponseData
object
Opsgenie service data from a response.
3 properties 3 required
ServiceDefinitionV2Pagerduty
string
PagerDuty service URL for the service.
ServiceDefinitionV2Dot2
object
Service definition v2.2 for providing service metadata and integrations.
15 properties 2 required
ServiceDefinitionV2Link
object
Service's external links.
3 properties 3 required
ServiceDefinitionV2Dot1MSTeams
object
Service owner's Microsoft Teams.
3 properties 2 required
ServiceDefinitionV2OpsgenieRegion
string
Opsgenie instance region.
ServiceDefinitionV2Dot2Pagerduty
object
PagerDuty integration for the service.
1 property
ServiceDefinitionV1
object
Deprecated - Service definition V1 for providing additional service metadata and integrations.
8 properties 2 required
ServiceDefinitionV1Pagerduty
string
PagerDuty service URL for the service.
ServiceDefinitionV2SlackType
string
Contact type.
ServiceDefinitionV1Info
object
Basic information about a service.
4 properties 1 required
OpsgenieServiceType
string
Opsgenie service resource type.
ServiceDefinitionGetResponse
object
Get service definition response.
1 property
ServiceDefinitionV2MSTeamsType
string
Contact type.
ServiceDefinitionV1Integrations
object
Third party integrations that Datadog supports.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-single-api-openapi.yml Raw ↑

Other APIs Datadog publishes across the network.

Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
Where this information came from

This is an independent, third-party profile of Datadog Single API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.