> ## Documentation Index
> Fetch the complete documentation index at: https://sirjosh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Clear List

> This endpoint clear all items from a list.



## OpenAPI

````yaml api-reference/openapi3.json post /3/list/{list_id}/clear
openapi: 3.0.3
info:
  title: The Movie Database
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: AUTHENTICATION
  - name: ACCOUNT
  - name: CERTIFICATIONS
  - name: CHANGES
  - name: COLLECTIONS
  - name: COMPANY
  - name: CONFIGURATION
  - name: CREDIT
  - name: DISCOVER
  - name: FIND
  - name: GENRES
  - name: GUEST SESSIONS
  - name: KEYWORDS
  - name: LISTS
  - name: MOVIE LISTS
  - name: MOVIES
  - name: NETWORKS
  - name: PEOPLE LIST
  - name: PEOPLE
  - name: REVIEWS
  - name: SEARCH
  - name: TRENDING
  - name: TV SERIES LIST
  - name: TV SERIES
  - name: TV SEASONS
  - name: TV EPISODES
  - name: TV EPISODE GROUP
  - name: WATCH PROVIDERS
paths:
  /3/list/{list_id}/clear:
    post:
      tags:
        - LISTS
      summary: Clear List
      description: This endpoint clear all items from a list.
      operationId: clearList
      parameters:
        - name: session_id
          in: query
          required: true
          description: >-
            A token that represents a logged-in user's session after they have
            authenticated with their TMDB account.
          schema:
            type: string
            example: ''
        - name: confirm
          in: query
          required: true
          description: This confirm if you want to clear all the items in the list.
          schema:
            type: string
            enum:
              - true
              - false
            example: 'true'
        - $ref: '#/components/parameters/list_id'
      responses:
        '201':
          description: clear list
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Length:
              schema:
                type: string
                example: '94'
            Date:
              schema:
                type: string
                example: Fri, 03 Jan 2025 21:52:50 GMT
            Server:
              schema:
                type: string
                example: openresty
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 368146333bf1a1071e8432a7d4e41e1a.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: ReNpkryUITHj_4sccDCvxg-5KYXtUNAnFfN3nKZL0VtRpm0BGN-FCQ==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: IAD89-C3
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            cache-control:
              schema:
                type: string
                example: public, max-age=0
            etag:
              schema:
                type: string
                example: W/"04302547257ccb7e68844cdd59055002"
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/listProperty'
              examples:
                clear list:
                  value:
                    status_code: 12
                    status_message: The item/record was updated successfully.
                    success: true
components:
  parameters:
    list_id:
      name: list_id
      in: query
      required: true
      description: This is the unique identifier of the list been created
      schema:
        type: number
        example: ''
  schemas:
    listProperty:
      type: object
      properties:
        status_code:
          type: number
          example: 12
          description: >-
            An integer value representing the status of the response. A value of
            1 is often used to denote a generic success response.
        status_message:
          type: string
          example: The item/record was updated successfully.
          description: A string providing a brief indication of the status of the request.
        success:
          type: boolean
          example: true
          description: A boolean value indicating whether the request was successful.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````