# Remove titles from a List

> Removes titles from a Media or Game List the user owns.

`POST /account/lists/{id}/titles/remove` on `https://api.mediux.io`

A title that is not on the List is ignored and not counted. A change is all or nothing. Making a List public or private takes effect at once; other changes to a Public List can take up to an hour to show on the public List routes.

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: `lists:write`.

## Parameters

- `id` (path, string, required): The List's ID (a lowercase UUID). A List the user neither owns nor subscribes to, or a malformed ID, is `404` `list.notFound`.

## Request body (`application/json`)

- `titles` (array of object, required)
  - `kind` (string, required): One of "show", "movie", "collection", "game", "person", "network", "company", "category".
  - `id` (integer, required)

## Responses

### 200

How many titles were removed.

- `data` (object, required)
  - `removed` (integer, required)

### 400

The request is malformed or failed validation. Inspect `error.code` and `error.issues`.

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 404

The resource does not exist or is not the user's.

### 409

The request conflicts with current state or a limit. Inspect `error.code` and `error.details`.

### 413

The body exceeds the allowed size.

### 415

The `Content-Type` is not `application/json`.

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (200)

```json
{
  "data": {
    "removed": 0
  }
}
```
