Update site maintenance | Modular DS

Turns the site’s WordPress maintenance mode on or off and updates its customization. All fields are optional (sometimes): status (on / off), noindex (boolean), background (hex color), title (max 70) and description (max 250).

The four customization fields are plan-gated: an organization without the maintenance permission in its plan may still toggle status, but sending any customization field answers 422.

Answers 200 with the same extended sites document as Show site maintenance, reflecting the stored settings. The change is propagated to WordPress asynchronously through the connector — the response confirms the request was stored and queued, not that the site already switched. Disabling maintenance also re-verifies the site connection in the background.

Read-only tokens answer 403; sites of other organizations answer 404. The MCP twin of this endpoint is the sites-maintenance-update tool.

Turns the site's WordPress maintenance mode on or off and updates its customization. All fields are optional (`sometimes`): `status` (`on` / `off`), `noindex` (boolean), `background` (hex color), `title` (max 70) and `description` (max 250). The four customization fields are plan-gated: an organization without the maintenance permission in its plan may still toggle `status`, but sending any customization field answers 422. Answers 200 with the same extended `sites` document as `Show site maintenance`, reflecting the stored settings. The change is propagated to WordPress asynchronously through the connector — the response confirms the request was stored and queued, not that the site already switched. Disabling maintenance also re-verifies the site connection in the background. Read-only tokens answer 403; sites of other organizations answer 404. The MCP twin of this endpoint is the `sites-maintenance-update` tool.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

sitestringRequired

Request

This endpoint expects an object.

titlestringRequired

statusstringRequired

noindexbooleanRequired

backgroundstringRequired

descriptionstringRequired

Response

Successful response

The four customization fields are plan-gated: an organization without the maintenance permission in its plan may still toggle status, but sending any customization field answers 422.

Read-only tokens answer 403; sites of other organizations answer 404. The MCP twin of this endpoint is the sites-maintenance-update tool.

1	curl -X PATCH https://https//https/api/public/v1/sites/site/maintenance \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"title": "We will be right back",
6	"status": "on",
7	"noindex": true,
8	"background": "#1a1a2e",
9	"description": "Scheduled maintenance in progress."
10	}'