---
title: "Update Watch"
method: PATCH
path: "/v1/mentions/watches/{watch_id}"
tags: ["mentions"]
---

# Update Watch

`PATCH /v1/mentions/watches/{watch_id}`

## Request

- Base URL: `https://api.snoopscan.com`
- URL: `https://api.snoopscan.com/v1/mentions/watches/{watch_id}`
- Auth: none declared

## Path parameters

- `watch_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- WatchUpdate
  - `name` string, nullable: A new name.
  - `keywords` string[], nullable: Replaces the keywords.
  - `competitors` string[], nullable: Replaces the competitor keywords.
  - `exclude` string[], nullable: Replaces the excluded words.
  - `platforms` string[], nullable: Replaces the platforms.
  - `feeds` string[], nullable: Replaces the feed addresses.
  - `categories` string[], nullable: Replaces the categories kept.
  - `customWords` object, nullable: Replaces your own category words.
  - `intervalMinutes` integer, nullable: Minutes between checks.
  - `webhook` string, nullable: A new webhook URL; empty removes it.
  - `active` boolean, nullable: Pause (false) or resume (true) the watch.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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