Skip to main content
PATCH
/
v1
/
watches
/
{id}
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)" }'

​
Path Parameters

​
id
string
required
Watch ID (wat_*).

​
Body Parameters

All fields optional. Omitted fields are unchanged.
​
name
string
1—255 chars.
​
query
object
Replace the entire saved query DSL. Same validation rules as Create Watch.
​
delivery_mode
string
Currently only always_per_alert is accepted (same as Create Watch). Digest modes land in v1.1 — sending one today returns 400.
​
status
string
active or paused. Use Pause / Resume for clarity.
​
metadata
object
Free-form metadata.

​
Response

Returns the updated Watch.

​
Example

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)" }'