---
title: "Cancel a watch"
method: DELETE
path: "/v1/watches/{watch_id}"
---

# Cancel a watch

`DELETE /v1/watches/{watch_id}`

## Request

- Base URL: `https://api.reqbeat.com`
- URL: `https://api.reqbeat.com/v1/watches/{watch_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Cancel a watch, scoped to the caller's own customer -- canceling
another tenant's watch id 404s, identical to canceling one that doesn't
exist (fail-fast, mirrors `delete_key`). Canceling one's own
already-canceled watch is a 204 no-op, so the verb stays idempotent.

Requires the `webhooks` scope.

## Path parameters

- `watch_id` integer, required: The watch subscription's id, as returned when the watch was created.

## Response `204`

Successful Response

## Other responses

- `401`: No API key was sent.
- `403`: The presented key is invalid or revoked, or (see `x-required-scope` on this operation) it does not carry the scope this operation requires.
- `422`: Validation Error

---

[API](https://skmtc.dev/reqbeat/apis/reqbeat-api.md) · [All operations](https://skmtc.dev/reqbeat/apis/reqbeat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqbeat/apis/reqbeat-api/revisions/4758e5957e8c?raw)