Remove Item

This endpoint remove items from a list

DELETE /4/list/{list_id}/items

Try it

Remove Item

cURL

curl --request DELETE \
  --url https://api.themoviedb.org/4/list/{list_id}/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "media_id": 550,
      "media_type": "movie"
    },
    {
      "media_id": 244786,
      "media_type": "movie"
    },
    {
      "media_id": 1396,
      "media_type": "tv"
    }
  ]
}
'

200

{
  "results": [
    {
      "media_id": 550,
      "media_type": "movie",
      "success": false
    },
    {
      "media_id": 244786,
      "media_type": "movie",
      "success": false
    },
    {
      "media_id": 1396,
      "media_type": "tv",
      "success": false
    }
  ],
  "status_code": 1,
  "status_message": "Success.",
  "success": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

list_id · integer · required

the ID of the custom list

Example:

8510518

Body

application/json

items · object[]

Show child attributes

items. media_id · integer

The id of the media

Example:

550

items. media_type · string

The type of media (e.g., movie)

Example:

"movie"

Example:

[
  { "media_id": 550, "media_type": "movie" },
  { "media_id": 244786, "media_type": "movie" },
  { "media_id": 1396, "media_type": "tv" }
]

Response

200 - application/json

Remove Item

results · object[]

Show child attributes

results. media_id · integer

Example:

550

results. media_type · string

results. success · boolean

Example:

false

Example:

[
  {
    "media_id": 550,
    "media_type": "movie",
    "success": false
  },
  {
    "media_id": 244786,
    "media_type": "movie",
    "success": false
  },
  {
    "media_id": 1396,
    "media_type": "tv",
    "success": false
  }
]

status_code · number

Example:

1

status_message · string

Example:

"Success."

success · boolean

Example:

true