---
title: "Remove categories"
method: POST
path: "/category/remove"
---

# Remove categories

`POST /category/remove`

## Request

- Base URL: `http://localhost:21721`
- URL: `http://localhost:21721/category/remove`
- Auth: HTTP bearer

Removes a set of categories. This can include any possible children categories and stores associated with the category.

Some special categories, for example the root categories, can not be removed.

## Request body

- CategoryRemoveRequest
  - `categories` string[], required: The categories to remove
  - `removeChildrenCategories` boolean, required: Whether to also remove any children categories
  - `removeContents` boolean, required: Whether to also remove any store entries in the categories. If this is false, any stores are moved to the default category instead.

## Response `200`

The removal was successful.

## Other responses

- `400`: Bad request. Please check error message and your parameters.
- `401`: Authorization failed. Please supply a `Bearer` token via the `Authorization` header.
- `403`: Authorization failed. Please supply a valid `Bearer` token via the `Authorization` header.
- `500`: Internal error.

---

[API](https://skmtc.dev/xpipe/apis/xpipe-api-documentation.md) - [All operations](https://skmtc.dev/xpipe/apis/xpipe-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/xpipe/apis/xpipe-api-documentation/revisions/cc0e84caab21?raw)