---
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.

## Changes

- **2026-07-26** `98b76167687f` — 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/cardinalapps/apis/cardinal-media-server-api/changes/api/v1/reset/post.md)

---

[API](https://skmtc.dev/cardinalapps/apis/cardinal-media-server-api.md) · [All operations](https://skmtc.dev/cardinalapps/apis/cardinal-media-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardinalapps/cardinal-media-server-api/revisions/7b5e4555e84f/schema)