---
title: "Clear"
method: POST
path: "/3/list/{list_id}/clear"
---

# Clear

`POST /3/list/{list_id}/clear`

## Request

- Base URL: `https://api.themoviedb.org`
- URL: `https://api.themoviedb.org/3/list/{list_id}/clear`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/themoviedb/apis/tmdb-api/docs/3/list/:list_id/clear/post.ts> (a function with typed inputs; its response is checked against the schema)

Clear all items from a list.

## Path parameters

- `list_id` integer, required

## Query parameters

- `session_id` string, required
- `confirm` boolean, required

## Response `200`

200

- object
  - `status_code` integer
  - `status_message` string

## Changes

- **2026-11-03** `1c709375fe99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/themoviedb/apis/tmdb-api/changes/3/list/:list_id/clear/post.md)

---

[API](https://skmtc.dev/themoviedb/apis/tmdb-api.md) - [All operations](https://skmtc.dev/themoviedb/apis/tmdb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/themoviedb/apis/tmdb-api/revisions/1c709375fe99?raw)