Update personal list

🔒 OAuth Required

Update a personal list by sending 1 or more parameters. If you update the list name, the original slug will still be retained so existing references to this list won't break.

Privacy

Lists will be private by default. Here is what each value means.

ValuePrivacy impact...
privateOnly you can see the list.
linkAnyone with the share_link can see the list.
friendsOnly your friends can see the list.
publicAnyone can see the list.

JSON POST Data

| Key | Type | Value |
|---|---|---|---|
| name | string | Name of the list. |
| description | string | Description for this list. |
| privacy | string | private, link, friends, public |
| display_numbers | boolean | Should each item be numbered? |
| allow_comments | boolean | Are comments allowed? |
| sort_by | string | rank, added, title, released, runtime, popularity, random, percentage, imdb_rating, tmdb_rating, rt_tomatometer, rt_audience, metascore, votes, imdb_votes, tmdb_votes, my_rating, watched, collected |
| sort_how | string | asc, desc |

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The slug that identifies the user, or "me" for the authenticated user.

string
required
Body Params

Body

string | null
string | null
string | null
boolean | null
boolean | null
string | null

The field to sort by

string | null
enum

The direction to sort in

Allowed:
Response

Language
Credentials
Required Scopes
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json