---
title: "Update monitor"
method: PATCH
path: "/api/v1/monitors/{id}"
tags: ["Monitors"]
---

# Update monitor

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

Update a monitor configuration, schedule, or status.

## Path parameters

- `id` string, required

## Request body

- UpdateMonitorDto
  - `name` string
  - `config` object
  - `cadence_minutes` number
  - `max_results` number
  - `force_fresh` boolean
  - `cache_ttl_days` number
  - `status` 'active' | 'paused' — Only active and paused are user-settable

## Response `200`

Monitor updated.

- MonitorResponseDto
  - `id` string, required
  - `name` string, required
  - `type` 'linkedin_keyword' | 'linkedin_profile' | 'linkedin_company' | 'linkedin_post' | 'instagram_profile' | 'instagram_post' | 'x_profile' | 'x_keyword' | 'reddit_keyword' | 'reddit_subreddit' | 'tiktok_keyword' | 'tiktok_hashtag' | 'web_search' | 'site_search', required
  - `status` 'active' | 'paused' | 'disabled', required
  - `config` object, required
  - `cadence_minutes` number, required
  - `last_run_at` string, nullable, required
  - `next_run_at` string, nullable, required
  - `consecutive_failures` number, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400` — The request body or parameters are invalid.
- `401` — Authentication is required.
- `404` — The requested resource was not found.
- `500` — An unexpected error occurred.

---

[API](https://skmtc.net/thehog/apis/the-hog-api.md) · [All operations](https://skmtc.net/thehog/apis/the-hog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thehog/the-hog-api/revisions/f5056017668a/schema)