---
title: "Pause or resume a watch"
method: PATCH
path: "/api/v1/watch/{id}"
tags: ["Monitoring"]
---

# Pause or resume a watch

`PATCH /api/v1/watch/{id}`

## Request

- Base URL: `https://namesniper.pro`
- URL: `https://namesniper.pro/api/v1/watch/{id}`
- Auth: HTTP bearer

## Request body

- object
  - `status` 'watching' | 'paused', required

## Response `200`

Updated watch.

- object
  - `success` unknown
  - `data` Watch
    - `id` string, required
    - `username` string, required
    - `platform` 'youtube' | 'tiktok' | 'instagram' | 'twitter' | 'github' | 'npm' | 'twitch' | 'threads' | 'bluesky' | 'pinterest' | 'snapchat' | 'kick' | 'linktree' | 'roblox' | 'telegram', required
    - `status` string, required: Current watch state, e.g. watching or paused.
    - `lastStatus` string, nullable: Last observed availability status.
    - `lastCheckedAt` string, date-time, nullable
    - `lastChangedAt` string, date-time, nullable
    - `checkCount` integer
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid request (missing field, bad JSON, or invalid value).
- `401`: Missing or invalid API key.
- `404`: Resource not found or not owned by the caller.

---

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