Summary

Update a custom list.

URL

http://api.trakt.tv/lists/update/apikey

Supported formats

json

Supported request methods

POST

Requires authentication

true (details)

Required Parameters

• apikey

  Sign in to view your API key.

• JSON POST

  • username

    trakt username.

  • password

    SHA1 hash of trakt password.

  • slug

    Slug to identify what list is being updated.

  • name (optional)

    The list name. This must be unique.

  • description (optional)

    Optional but recommended description of what the list contains.

  • privacy (optional)

    Privacy level, set it to private, friends, or public.

  • show_numbers (optional)

    The list should show numbers for each item. This is useful for ranked lists. Set it to true or false.

  • allow_shouts (optional)

    The list allows discussion by users who have access. Set it to true or false.

Example JSON POST

{
	"username": "username",
	"password": "sha1hash",
	"slug": "top-10-of-2011",
	"name": "Top 20 of 2011",
	"privacy": "friends",
	"show_numbers": true,
	"allow_shouts": true
}

Example Response

{
	"status": "success",
	"message": "list updated",
	"name": "Top 20 of 2011",
	"slug": "top-20-of-2011",
	"privacy": "friends",
	"show_numbers": true,
	"allow_shouts": true
}