---
title: "Delete"
method: DELETE
path: "/3/list/{list_id}"
---

# Delete

`DELETE /3/list/{list_id}`

## Request

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

Delete a list.

## Path parameters

- `list_id` integer, required

## Query parameters

- `session_id` string, 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/delete.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)