Cancel downtimes by scope

Delete all downtimes that match the scope of X. Note: This only interacts with Downtimes created using v1 endpoints. This endpoint has been deprecated and will not be replaced. Please use v2 endpoints to find and cancel downtimes.

post/api/v1/downtime/cancel/by_scope

Request

Base URL
https://api.datadoghq.com
URL
https://api.datadoghq.com/api/v1/downtime/cancel/by_scope
Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2
  Authorization code: /oauth2/v1/authorize
  Token URL: /oauth2/v1/token scopes: monitors_downtime

Request body

scopestring required

The scope(s) to which the downtime applies and must be in key:value format. For example, host:app2. Provide multiple scopes as a comma-separated list like env:dev,env:prod. The resulting downtime applies to sources that matches ALL provided scopes (env:dev AND env:prod).

Example request

{
  "scope": "host:myserver"
}

Response

cancelled_idsinteger[]

ID of downtimes that were canceled.

Example response

{
  "cancelled_ids": [
    123456789,
    123456790
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.