---
title: "Set a server to maintenance mode"
method: GET
path: "/api/clusters/{clusterName}/servers/{serverName}/actions/set-maintenance"
tags: ["DatabaseMaintenance"]
---

# Set a server to maintenance mode

`GET /api/clusters/{clusterName}/servers/{serverName}/actions/set-maintenance`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Sets a specified server within a cluster to maintenance mode.
Maintenance mode is durable: it is written to the cluster's
dynamic configuration and restored on process restart or config
reload, so the server stays excluded from proxy routing and
failover election until maintenance is explicitly cleared.
Requires monitoring-save-config=true (the default) to survive a
restart.

## Path parameters

- `clusterName` string, required
- `serverName` string, required

## Headers

- `Authorization` string, required

## Response `200`

Server set to maintenance mode successfully

- string

## Other responses

- `403`: No valid ACL
- `500`: Cluster Not Found" or "Server Not Found

## Changes

- **2026-07-17** `7465ea0ee21a`: 1 info
  - endpoint added
- **2023-03-31** `b57fc7b9446e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/:clusterName/servers/:serverName/actions/set-maintenance/get.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)