---
title: "Change a monitor's name, cadence, anchor, timezone, capture profile or change policy"
method: PATCH
path: "/v1/monitors/{monitorId}"
tags: ["Monitors"]
---

# Change a monitor's name, cadence, anchor, timezone, capture profile or change policy

`PATCH /v1/monitors/{monitorId}`

## Request

- Base URL: `https://api.ironfang.com/audit`
- URL: `https://api.ironfang.com/audit/v1/monitors/{monitorId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

A cadence, anchor or timezone change clears the next slot; the scheduler recomputes it on its next tick.

## Request body

- MonitorInput: `mode` is `full_site` (crawler discovery under the site's crawl policy) or `url_set` (exactly the given `urls`). Every `cadence` is open to every organisation; `manual` monitors only run when asked. `anchor_minute` is minutes past midnight in `timezone` for daily cadences, or minutes into the interval otherwise.
  - `anchor_minute` integer
  - `cadence` 'manual' | 'daily' | 'six_hourly' | 'hourly'
  - `capture_profile` CaptureProfile: Viewport and rendering settings for the monitor's evidence captures. Clamped to Ironfang Render's ceilings.
    - `color_scheme` 'light' | 'dark'
    - `device_scale_factor` number
    - `height` integer
    - `locale` string
    - `width` integer
  - `change_policy` ChangePolicy: When a page observation counts as changed.
    - `ignore_numbers` boolean
    - `ignored_selectors` string[]
    - `min_text_change` number: Fraction of text that must differ, 0-1.
    - `min_visual_change` number: Fraction of pixels that must differ, 0-1.
    - `notify_only_on_rule_change` boolean
  - `mode` 'full_site' | 'url_set', required
  - `name` string
  - `timezone` string: An IANA zone name, for example Europe/London.
  - `urls` string[]: Required for url_set on creation; ignored on update.

## Response `200`

Monitor

## Other responses

- `409`: The monitor is archived

---

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