> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Watch

> Stop a watch from evaluating

## Overview

Deleting a watch stops it from evaluating. Existing alerts it already produced remain
retrievable and still reference the watch by ID, they aren't deleted along with it. Requires the
`portfolios:manage` scope.

## Path Parameters

<ParamField path="id" type="string" required>Watch ID (`wat_*`).</ParamField>

## Response

<ResponseField name="id" type="string">The deleted watch ID.</ResponseField>
<ResponseField name="object" type="string">Always `"watch"`.</ResponseField>
<ResponseField name="deleted" type="boolean">Always `true`.</ResponseField>
<ResponseField name="request_id" type="string">Request identifier.</ResponseField>

A deleted watch no longer appears in [List Watches](/api-reference/monitoring/watches/list).

## Errors

| Status | `type`      | When                                          |
| ------ | ----------- | --------------------------------------------- |
| 404    | `not_found` | Watch doesn't exist or belongs to another org |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://api.signa.so/v1/watches/wat_8kLm2nPq" \
    -H "Authorization: Bearer sig_YOUR_KEY" \
    -H "Idempotency-Key: delete-wat-8kLm2nPq-2026-06-12"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";
  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  await signa.watches.delete("wat_8kLm2nPq");
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "id": "wat_8kLm2nPq",
    "object": "watch",
    "deleted": true,
    "request_id": "req_9pQ2vXpL"
  }
  ```
</ResponseExample>

## Related Endpoints

* [List Watches](/api-reference/monitoring/watches/list) - deleted watches are excluded
* [Retrieve Alert](/api-reference/monitoring/alerts/retrieve) - alerts from a deleted watch remain retrievable
* [Pause Watch](/api-reference/monitoring/watches/pause) - stop evaluation without deleting the watch