---
title: "🛡️ Deindex one or more of your files."
method: DELETE
path: "/api/v1/index/files"
tags: ["Indexing"]
---

# 🛡️ Deindex one or more of your files.

`DELETE /api/v1/index/files`

Deindexes one or more files. To "deindex" means to delete the file entity
and all of its derived entities like songs and episodes, and all of their
derived entities like metadata and thumbnails.

Deindexing however does not delete cached static resources on the disk like
the thumbnail files that the server generates when initially indexing
things. Those now stale assets will eventually be deleted by a cleanup cron
job.

If a wildcard (`*`) is given as the sole item in the array, all files will
be deindexed. The wildcard method only supports hard deleting, so you must
also set `hardDelete` to true to activate it. Only a `true` boolean will be
returned when the wildcard operation is done.

By default, this deindexing is a soft delete. To perform a hard delete, set
the `hardDelete` param to true.
<!-- Leave this line empty -->
<br /><hr /><h3>🛡️ Requires Capabilities: <code>Indexing.Deindex</code></h3>

## Query parameters

- `ids` string[], required
- `hardDelete` boolean

## Response `200`

Returns an object of file IDs and booleans, indicating whether each file was successfully deindexed.

- unknown

## Other responses

- `401` — Possible reasons: The authorization token is invalid.
- `403` — Possible reasons: The user does not have sufficent capabilities.

---

[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/revisions/0c30e5146acd/schema)