---
title: "Update Maintenance Mode"
method: PATCH
path: "/v1/settings/maintenance-mode"
tags: ["settings"]
---

# Update Maintenance Mode

`PATCH /v1/settings/maintenance-mode`

Freeze or unfreeze dashboard sign-ins, for this and every other replica.

The new state is persisted and nothing is applied to the running worker,
because every reader goes back to the stored row. That is what makes one
call enough for a deployment running more than one of them.

## Request body

- UpdateMaintenanceModeRequest — Turn the sign-in freeze on or off.
  - `enabled` boolean, required — True to freeze new dashboard sign-ins, false to allow them again.

## Response `200`

Successful Response

- MaintenanceMode — Whether this deployment is currently refusing new dashboard sign-ins.
  - `enabled` boolean, required — When true, POST /v1/auth/session refuses every credential with 503 so nobody starts a new dashboard session during a redeploy. Sessions already issued keep working, and the management API and the data plane are unaffected: a caller presenting the master key or an API key through the header is never frozen out.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/7f178e92b56c/schema)