---
title: "Turn the monitor's free status page on or off (issue"
method: PUT
path: "/api/v1/monitors/{monitorID}/status-page"
tags: ["Monitors"]
---

# Turn the monitor's free status page on or off (issue

`PUT /api/v1/monitors/{monitorID}/status-page`

## Request

- Base URL: `https://api.uptimemonitoring.com`
- URL: `https://api.uptimemonitoring.com/api/v1/monitors/{monitorID}/status-page`
- Auth: HTTP bearer

Owner role only — publishing a public URL is an owner decision,
the same gate as `/account/feed-token`. Repeating `{"enabled":true}`
on an already-on page returns the same URL. `{"enabled":false}`
revokes the URL immediately at the origin (a caching CDN in front
of the status host may still serve the old page for up to 60
seconds — see `STATUS_PAGE_URL`/`Free Status Page` in SPEC.md).
Turning it back on mints a different token. The body must be
exactly `{"enabled": <bool>}` — a missing or null `enabled`, a
non-boolean value, or any other key is `400` and leaves the
stored token unchanged.

## Path parameters

- `monitorID` integer, required

## Request body

- object
  - `enabled` boolean, required

## Response `200`

Updated switch state.

- StatusPageSettings: The owner's free status-page switch state for one monitor (issue #368). `url` is `null` when the page is off.
  - `enabled` boolean, required
  - `url` string, uri, nullable, required

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid credentials.
- `403`: Caller is not an owner, or the account is suspended.
- `404`: Monitor not found or belongs to another account.
- `413`: Request body exceeds the 64 KB hard limit. Per docs/SPEC.md §Hard Limits the dispatcher rejects any payload larger than 65,536 bytes before it is decoded.
- `415`: The request `Content-Type` is not `application/json`. Write operations (POST, PUT, PATCH) require that header; a missing or non-JSON media type is rejected before the body is read. The `charset` parameter is accepted and ignored, so `application/json; charset=utf-8` is valid.

---

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