---
title: "Cancel downtimes by scope"
method: POST
path: "/api/v1/downtime/cancel/by_scope"
tags: ["Downtimes"]
deprecated: true
---

# Cancel downtimes by scope

`POST /api/v1/downtime/cancel/by_scope`

> **Deprecated.**

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.

## Request body

- CancelDowntimesByScopeRequest — Cancel downtimes according to scope.
  - `scope` string, 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`).

## Response `200`

OK

- CanceledDowntimesIds — Object containing array of IDs of canceled downtimes.
  - `cancelled_ids` integer[] — ID of downtimes that were canceled.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Downtimes not found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)