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 APM Service Level Objectives API

[Service Level Objectives](https://docs.datadoghq.com/monitors/service_level_objectives/#configuration)(or SLOs) are a key part of the site reliability engineering toolkit.SLOs provide a framework for defining clear targets around application performance,which ultimately help teams provide a consistent customer experience,balance feature development with platform stability,and improve communication with internal and external users.

Datadog APM Service Level Objectives API is one of 8 APIs that Datadog APM publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include SLO. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 10 operations across 7 paths, and defines 78 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

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

10 operations 7 paths 78 schemas 1 DELETE6 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 6

Datadog APM Service Level Objectives API declares 6 security schemes for authenticating requests. It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 67 scopes. An API key is passed in the header as DD-API-KEY (apiKeyAuth). An API key is passed in the query as api_key (apiKeyAuthQuery). An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth). An API key is passed in the query as application_key (appKeyAuthQuery). 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.
  • apiKeyAuthQuery — Deprecated API Key as query argument.
  • appKeyAuth — Your Datadog APP Key.
  • appKeyAuthQuery — Deprecated APP Key as query argument.

Paths & Operations 10

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

Service Level Objectives 10

Service Level Objectives (or SLOs) are a key part of the site reliability engineering toolkit. SLOs provide a framework for defining clear targets around application performance,…

GET
/api/v1/slo
Get all SLOs
ListSLOs 7 params → 200400403404429
POST
/api/v1/slo
Create an SLO object
CreateSLO body → 200400403429
POST
/api/v1/slo/bulk_delete
Bulk Delete SLO Timeframes
DeleteSLOTimeframeInBulk body → 200400403429
GET
/api/v1/slo/can_delete
Check if SLOs can be safely deleted
CheckCanDeleteSLO 1 param → 200400403409429
GET
/api/v1/slo/search
Search for SLOs
SearchSLO 4 params → 200400403429
DELETE
/api/v1/slo/{slo_id}
Delete an SLO
DeleteSLO 2 params → 200403404409429
GET
/api/v1/slo/{slo_id}
Get an SLO's details
GetSLO 2 params → 200403404429
PUT
/api/v1/slo/{slo_id}
Update an SLO
UpdateSLO 1 param body → 200400403404429
GET
/api/v1/slo/{slo_id}/history
Get an SLO's history
GetSLOHistory 5 params → 200400403404429
GET
/api/v1/slo/{slo_id}/corrections
Get Corrections For an SLO
GetSLOCorrections 1 param → 200400403404429

Schemas 78

The contract defines 78 schemas that model the data the API accepts and returns. The most detailed are SLOResponseData (18 properties), ServiceLevelObjective (17 properties), SearchServiceLevelObjectiveAttributes (16 properties), SLOCorrectionResponseAttributes (13 properties). Each schema is shown below with its type and property counts.

SLOState
string
State of the SLO.
SearchSLOResponseDataAttributesFacetsObjectInt
object
Facet
2 properties
CheckCanDeleteSLOResponse
object
A service level objective response containing the requested object.
2 properties
SLOHistoryResponseErrorWithType
object
An object describing the error with error type and error message.
2 properties 2 required
SLOHistoryMetrics
object
A metric based SLO history response. This is not included in responses for monitor based SLOs.
8 properties 7 required
SLOBulkDeleteError
object
Object describing the error.
3 properties 3 required
SLOTimeSliceInterval
integer
The interval used when querying data, which defines the size of a time slice. Two values are allowed: 60 (1 minute) and 300 (5 minutes). If not provided, the v…
SLOHistoryMetricsSeries
object
A representation of metric based SLO timeseries for the provided queries. This is the same response type from batchquery endpoint.
4 properties 3 required
SLOOverallStatuses
object
Overall status of the SLO by timeframes.
9 properties
FormulaAndFunctionMetricQueryDefinition
object
A formula and functions metrics query.
6 properties 3 required
SLOListResponseMetadata
object
The metadata object containing additional information about the list of SLOs.
1 property
SLOListResponse
object
A response with one or more service level objective.
3 properties
FormulaAndFunctionMetricAggregation
string
The aggregation methods available for metrics queries.
SLOHistoryResponse
object
A service level objective history response.
2 properties
SLOSliSpec
A generic SLI specification. This is used for time-slice and count-based (metric) SLOs only.
ResponseMetaAttributes
object
Object describing meta attributes of response.
1 property
SLOBulkDeleteResponse
object
The bulk partial delete service level objective object endpoint response. This endpoint operates on multiple service level objective objects, so it may be part…
2 properties
SLOHistorySLIData
object
An object that holds an SLI value and its associated data. It can represent an SLO's overall SLI value. This can also represent the SLI value for a specific mo…
12 properties
SLOTimeSliceSpec
object
A time-slice SLI specification.
1 property 1 required
SearchServiceLevelObjectiveData
object
A service level objective ID and attributes.
3 properties
SLOCountDefinition
A count-based (metric) SLI specification, composed of three parts: the good events formula, the bad or total events formula, and the underlying queries. Exactl…
SLOFormula
object
A formula that specifies how to combine the results of multiple queries.
1 property 1 required
SLOCorrection
object
The response object of a list of SLO corrections.
3 properties
SearchServiceLevelObjective
object
A service level objective data container.
1 property
ServiceLevelObjectiveQuery
object
A count-based (metric) SLO query. This field is superseded by slispecification but is retained for backwards compatibility. Note that Datadog only allows the s…
2 properties 2 required
SLORawErrorBudgetRemaining
objectnull
Error budget remaining for an SLO.
2 properties
SLOTimeSliceComparator
string
The comparator used to compare the SLI value to the threshold.
SLOListResponseMetadataPage
object
The object containing information about the pages of the list of SLOs.
2 properties
SLOCorrectionType
string
SLO correction resource type.
SearchSLOResponseMetaPage
object
Pagination metadata returned by the API.
8 properties
SLOTimeSliceQuery
object
The queries and formula used to calculate the SLI value.
2 properties 2 required
SearchSLOResponseDataAttributes
object
Attributes
2 properties
CrossOrgUuids
array
The source organization UUID for cross organization queries. Feature in Private Beta.
SLOThreshold
object
SLO thresholds (target and optionally warning) for a single time window.
5 properties 2 required
SLOCorrectionResponseAttributesModifier
objectnull
Modifier of the object.
3 properties
SLOType
string
The type of the service level objective.
SLODataSourceQueryDefinition
A formula and function query.
CheckCanDeleteSLOResponseData
object
An array of service level objective objects.
1 property
SearchSLOTimeframe
string
The SLO time window options.
SLOCountSpec
object
A metric SLI specification.
1 property 1 required
SLOHistoryMetricsSeriesMetadataUnit
objectnull
An Object of metric units.
6 properties
APIErrorResponse
object
Error response object.
1 property 1 required
SLOCorrectionResponseAttributes
object
The attribute object associated with the SLO correction.
13 properties
SLOTimeSliceCondition
object
The time-slice condition, composed of 3 parts: 1. the metric timeseries query, 2. the comparator, and 3. the threshold. Optionally, a fourth part, the query in…
4 properties 3 required
SearchSLOQuery
objectnull
A metric-based SLO. Required if type is metric. Note that Datadog only allows the sum by aggregator to be used because this will sum up all request counts inst…
3 properties
ServiceLevelObjectiveRequest
object
A service level objective object includes a service level indicator, thresholds for one or more timeframes, and metadata (name, description, tags, etc.).
12 properties 3 required
SearchSLOResponseDataAttributesFacetsObjectString
object
Facet
2 properties
SLOCountDefinitionWithBadEventsFormula
object
SLO count definition using a bad events formula alongside a good events formula.
3 properties 3 required
SearchSLOResponse
object
A search SLO response containing results from the search query.
3 properties
SLOHistoryMonitor
object
An object that holds an SLI value and its associated data. It can represent an SLO's overall SLI value. This can also represent the SLI value for a specific mo…
12 properties
SLOErrorBudgetRemainingData
object
A mapping of threshold timeframe to the remaining error budget.
SLOHistoryMetricsSeriesMetadata
object
Query metadata.
6 properties
Pagination
object
Pagination object.
2 properties
FormulaAndFunctionMetricDataSource
string
Data source for metrics queries.
SearchSLOResponseDataAttributesFacets
object
Facets
8 properties
SLOResponse
object
A service level objective response containing a single service level objective.
2 properties
Creator
object
Object describing the creator of the shared element.
3 properties
SearchSLOThreshold
object
SLO thresholds (target and optionally warning) for a single time window.
5 properties 2 required
FormulaAndFunctionMetricSemanticMode
string
Semantic mode for metrics queries. This determines how metrics from different sources are combined or displayed.
SLOCorrectionCategory
string
Category the SLO correction belongs to.
SearchSLOResponseLinks
object
Pagination links.
5 properties
SearchSLOResponseMeta
object
Searches metadata returned by the API.
1 property
SLOTypeNumeric
integer
A numeric representation of the type of the service level objective (0 for monitor, 1 for metric). Always included in service level objective responses. Ignore…
ServiceLevelObjective
object
A service level objective object includes a service level indicator, thresholds for one or more timeframes, and metadata (name, description, tags, etc.).
17 properties 3 required
SearchSLOResponseData
object
Data from search SLO response.
2 properties
SLODeleteResponse
object
A response list of all service level objective deleted.
2 properties
SLOCountDefinitionWithTotalEventsFormula
object
SLO count definition using a total events formula alongside a good events formula.
3 properties 3 required
SLOHistoryResponseError
object
A list of errors while querying the history data for the service level objective.
1 property
SLOStatus
object
Status of the SLO's primary timeframe.
7 properties
SLOTimeframe
string
The SLO time window options. Note that "custom" is not a valid option for creating or updating SLOs. It is only used when querying SLO history over custom time…
SLOErrorTimeframe
string
The timeframe of the threshold associated with this error or "all" if all thresholds are affected.
SLOBulkDeleteResponseData
object
An array of service level objective objects.
2 properties
SearchServiceLevelObjectiveAttributes
object
A service level objective object includes a service level indicator, thresholds for one or more timeframes, and metadata (name, description, and tags).
16 properties
SLOHistoryResponseData
object
An array of service level objective objects.
10 properties
SLOCorrectionListResponse
object
A list of SLO correction objects.
2 properties
SLOCreator
objectnull
The creator of the SLO
3 properties
SLOResponseData
object
A service level objective object includes a service level indicator, thresholds for one or more timeframes, and metadata (name, description, tags, etc.).
18 properties
SLOBulkDelete
object
A map of service level objective object IDs to arrays of timeframes, which indicate the thresholds to delete for each ID.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

datadog-apm-service-level-objectives-api-openapi.yml Raw ↑

Other APIs Datadog APM publishes across the network.

Datadog APM Spans API
Datadog APM Spans Metrics API
Datadog MCP Server
Datadog APM API
Datadog APM Retention Filters API
Datadog APM Service Definition API
Datadog APM Service Level Objective Corrections API
Where this information came from

This is an independent, third-party profile of Datadog APM Service Level Objectives 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.