---
title: "Remove one watch and its unread events"
method: DELETE
path: "/v1/agent/watches/{id}"
tags: ["Alerts"]
---

# Remove one watch and its unread events

`DELETE /v1/agent/watches/{id}`

## Request

- Base URL: `https://api.voidly.ai`
- URL: `https://api.voidly.ai/v1/agent/watches/{id}`
- Auth: API key in header `X-Agent-Key`

Removes the watch and its unread events; inbox notices not yet sent for it are not sent (notices already delivered stay in the relay inbox). Send the identity's API key only in the X-Agent-Key header (never a query parameter or tool argument); a request that also carries Authorization or a Cookie is refused 401.

## Path parameters

- `id` string, required

## Response `200`

Deleted.

- object
  - `success` true, required
  - `deleted_id` string, uuid, required

## Other responses

- `401`: Missing or unknown X-Agent-Key.
- `404`: watch_not_found: no such watch for this identity.
- `503`: Switched off: agent_watch_feed_disabled (Retry-After 3600). Storage failure: watch_storage_unavailable.

## Changes

- **2026-10-25** `a79d866dc548`: 1 warning, 12 info
  - deleted the `header` request parameter `X-Agent-Key`
  - the endpoint scheme security `AgentKeyAuth` was added to the API
  - added the optional property `message` to the response with the `401` status
  - added the optional property `message` to the response with the `404` status
  - …9 more
- **2026-10-24** `491e71a343b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voidly/apis/voidly-api/changes/v1/agent/watches/:id/delete.md)

---

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