---
title: "🛡️ Reset server state."
method: POST
path: "/api/v1/reset"
tags: ["General"]
---

# 🛡️ Reset server state.

`POST /api/v1/reset`

Deindexing media requires the `Indexing.Deindex` capability; a factory reset requires `MediaServer.FactoryReset`. Both types are gated behind a validation phrase that the user must type out: `Deindex media` and `Factory reset` respectively.<br /><hr /><h3>🛡️ Requires one of these Capabilities: <code>Indexing.Deindex</code> <code>MediaServer.FactoryReset</code></h3>

## Request body

- ServerResetDto
  - `type` 'media' | 'factory', required
  - `validationString` 'Deindex media' | 'Factory reset', required

## Response `201`

- boolean

## Other responses

- `400` — Possible reasons: Request validation failed, see response for details; The validation phrase does not match the reset type.
- `401` — Possible reasons: The authorization token is invalid.
- `403` — Possible reasons: The user lacks the capability for the requested reset type.

---

[API](https://skmtc.net/cardinalapps/apis/cardinal-media-server-api.md) · [All operations](https://skmtc.net/cardinalapps/apis/cardinal-media-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cardinalapps/cardinal-media-server-api/versions/0c30e5146acd/schema)