> ## 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.

# Update Watch

> Update a watch (PATCH semantics — partial body)

## Path Parameters

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

## Body Parameters

All fields optional. Omitted fields are unchanged.

<ParamField body="name" type="string">1--255 chars.</ParamField>
<ParamField body="query" type="object">Replace the entire saved query DSL. Same validation rules as [Create Watch](/api-reference/monitoring/watches/create).</ParamField>
<ParamField body="delivery_mode" type="string">Currently only `always_per_alert` is accepted (same as [Create Watch](/api-reference/monitoring/watches/create)). Digest modes land in v1.1 -- sending one today returns `400`.</ParamField>
<ParamField body="status" type="string">`active` or `paused`. Use [Pause](/api-reference/monitoring/watches/pause) / [Resume](/api-reference/monitoring/watches/resume) for clarity.</ParamField>
<ParamField body="metadata" type="object">Free-form metadata.</ParamField>

## Response

Returns the updated `Watch`.

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.signa.so/v1/watches/wat_01HK7M..." \
    -H "Authorization: Bearer $SIGNA_API_KEY" \
    -H "Content-Type: application/json" \
    -H "Idempotency-Key: rename-watch-2026-06-12" \
    -d '{ "name": "Class 9 filings (US only)" }'
  ```

  ```ts TypeScript theme={null}
  await signa.watches.update('wat_01HK7M...', {
    name: 'Class 9 filings (US only)',
  });
  ```
</RequestExample>