Changes the name, description or visibility of a List the user owns.
Send only the fields you change. Making a List private ends its subscriptions. A change is all or nothing. Making a List public or private takes effect at once; other changes to a Public List can take up to an hour to show on the public List routes.
Authorization
OAuth 2 bearer token in the Authorization header. Required scope: lists:write
Path parameters
idstring requiredThe List's ID (a lowercase UUID). A List the user neither owns nor subscribes to, or a malformed ID, is
404list.notFound.pattern
Request body required
Any of name, description and isPublic.
Content type:application/json
namestring optionalmin length 1max length 80descriptionstring | null optionalmax length 500isPublicboolean optional
Responses
200 The List.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataobjectShow options
One of
kind = "assetList"
kindstring"assetList"idstring (uuid)namestringdescriptionstring | nullownerobjectShow child attributes
idstring (uuid)usernamestringmin length 1
itemCountintegermin 0subscriberCountintegermin 0createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternitemsarray of objectShow item attributes
idstring (uuid)extensionstringpattern ^[a-z0-9]{2,5}$slotstring"poster""backdrop""logo""squareArt""titlecard""thumb""cover""hero""wideCover""background""squareCover""icon"entityobjectShow child attributes
kindstringidintegerpositive
languagestring | nullISO 639-1 code;
xxis textless.pattern ^[a-z]{2}$editionstring | null"theatricalCut""directorsCut""extendedCut""unratedCut""imaxVersion""criterionEdition""finalCut""fanEdit""producersCut""alternateColorGrading"widthintegerpositiveheightintegerpositivefileSizeintegermin 0setobject | nullShow child attributes
kindstring"showSet""movieSet""collectionSet""gameSet""talentSet""brandSet""categorySet"idintegerpositive
creatorobjectShow child attributes
idstring (uuid)usernamestringmin length 1
createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
Option 2
kindstring"mediaList""gameList"idstring (uuid)namestringdescriptionstring | nullownerobjectShow child attributes
idstring (uuid)usernamestringmin length 1
itemCountintegermin 0subscriberCountintegermin 0createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patterntitlesarray of objectShow item attributes
entityobjectShow child attributes
idintegerpositivetitlestringyearinteger | nullmin 1max 9999kindstring"show""season""episode""movie""collection""person""network""company""category""game"
positionintegermin 0posterobject | nullShow child attributes
idstring (uuid)extensionstringpattern ^[a-z0-9]{2,5}$languagestring | nullISO 639-1 code;
xxis textless.pattern ^[a-z]{2}$editionstring | null"theatricalCut""directorsCut""extendedCut""unratedCut""imaxVersion""criterionEdition""finalCut""fanEdit""producersCut""alternateColorGrading"widthintegerpositiveheightintegerpositivefileSizeintegermin 0setobject | nullShow child attributes
kindstring"showSet""movieSet""collectionSet""gameSet""talentSet""brandSet""categorySet"idintegerpositive
creatorobjectShow child attributes
idstring (uuid)usernamestringmin length 1
createdAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.patternupdatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
choiceCountintegermin 0updatedAtstringISO 8601 UTC instant with milliseconds, such as
2026-11-14T15:03:02.000Z.pattern
400 The request is malformed or failed validation. Inspect error.code and error.issues.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
401 The access token is missing (auth.required), or invalid, expired or revoked (auth.invalidToken).application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"WWW-AuthenticatestringRFC 6750 challenge:
Bearer realm="mediux", pluserror="invalid_token"for a bad or expired token.
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
403 The token lacks the required App Permission (auth.insufficientScope, with details.required), or the account or connection may not do this (auth.forbidden).application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
404 The resource does not exist or is not the user's.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
413 The body exceeds the allowed size.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
415 The Content-Type is not application/json.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
429 Too many requests. Wait the Retry-After seconds before trying again.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"Retry-AfterstringSeconds to wait before trying again.
pattern ^\d+$
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
503 Temporarily unavailable. Check the outcome before retrying a write.application/json
Headers
Cache-ControlstringBrowser caching policy.
"private, no-store"
dataany | nullAlways null on an error.
errorobjectWhy the request failed.
Show child attributes
codestringStable dotted camelCase code such as
resource.gone. Branch on this, not onmessage.messagestringShort explanation for people. Wording can change.
min length 1max length 256requestIdstringThe Cloudflare ray ID. Absent on Snippet and WAF errors and on cached
404,410and503responses, which carry it only incf-ray.min length 1docsstring (uri)Link to this code's entry in the error catalogue.
detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.
issuesarray of objectPer-field validation failures, when any.
max 50 itemsShow item attributes
codestringStable code for this field failure. Branch on this.
min length 1messagestringShort human-readable description of this field failure.
min length 1patharray of stringPath to the failing field, for example
["items", 2, "slot"].detailsmap of string | number | boolean | array of string | nullConstraints that apply to the failure, such as byte limits, dimensions or allowed types.