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

# Add items

> This endpoint allows users to add items to a specific list.



## OpenAPI

````yaml post /4/list/{list_id}/items
openapi: 3.0.3
info:
  title: Version 4
  description: This API is the version 4 of TMDB API
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
security:
  - bearerAuth: []
tags:
  - name: ACCOUNT
  - name: AUTH
  - name: LISTS
    description: For this folder, you will need to create an access token
paths:
  /4/list/{list_id}/items:
    parameters:
      - name: list_id
        description: the ID of the custom list
        in: path
        required: true
        schema:
          type: integer
          example: 8510518
    post:
      tags:
        - LISTS
      summary: Add items
      description: This endpoint allows users to add items to a specific list.
      operationId: addItems
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      media_id:
                        description: The id of the media
                        type: number
                        example: 550
                      media_type:
                        description: The type of media (e.g., movie)
                        type: string
                        example: movie
                  example:
                    - media_id: 550
                      media_type: movie
                    - media_id: 244786
                      media_type: movie
                    - media_id: 1396
                      media_type: tv
            examples:
              Add items:
                value:
                  items:
                    - media_id: 550
                      media_type: movie
                    - media_id: 244786
                      media_type: movie
                    - media_id: 1396
                      media_type: tv
      responses:
        '200':
          description: Add items
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: br
            Date:
              schema:
                type: string
                example: Mon, 03 Mar 2025 09:40:02 GMT
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 db0227634f5a6631ffed23eb54e5313e.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: Ds6Laxzc7CXY-4ow3vJeJpiNZk04iUoXcPe2vyGGMjTmqCNfdR2bug==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-P2
            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/"42594659bb3856db30b3b3ef4a13a44d"
            vary:
              schema:
                type: string
                example: accept-encoding
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        error:
                          type: array
                          items:
                            type: string
                            example: Media has already been taken
                          example:
                            - Media has already been taken
                        media_id:
                          type: number
                          example: 550
                        media_type:
                          type: string
                          example: movie
                        success:
                          type: boolean
                          example: false
                  status_code:
                    type: number
                    example: 1
                  status_message:
                    type: string
                    example: Success.
                  success:
                    type: boolean
                    example: true
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````