POST lists/destroy

Updated on Sat, 2012-08-25 11:08

Deletes the specified list. The authenticated user must own the list to be able to destroy it.

Resource URL

https://api.twitter.com/1/lists/destroy.format

Parameters

Either a list_id or a slug is required. If providing a list_slug, an owner_screen_name or owner_id is also required.

owner_screen_name optional

The screen name of the user who owns the list being requested by a slug.

owner_id optional

The user ID of the user who owns the list being requested by a slug.

list_id required

The numerical id of the list.

slug required

You can identify a list by its slug instead of its numerical id. If you decide to do so, note that you'll also have to specify the list owner using the owner_id or owner_screen_name parameters.

Example Request

POST

https://api.twitter.com/1/lists/destroy.json

POST Data

owner_screen_name=kurrik&slug=goonies

  1. {
  2.    "created_at":"Fri Nov 04 21:22:36 +0000 2011",
  3.    "slug":"goonies",
  4.    "name":"Goonies",
  5.    "full_name":"@kurrik\/goonies",
  6.    "description":"For life",
  7.    "mode":"public",
  8.    "following":false,
  9.    "user":{
  10.       "geo_enabled":true,
  11.       "profile_background_image_url_https":"https:\/\/si0.twimg.com\/profile_background_images\/342542280\/background7.png",
  12.       "profile_background_color":"8fc1ff",
  13.       "protected":false,
  14.       "default_profile":false,
  15.       "listed_count":127,
  16.       "profile_background_tile":true,
  17.       "created_at":"Thu Jul 19 15:58:07 +0000 2007",
  18.       "friends_count":291,
  19.       "name":"Arne Roomann-Kurrik",
  20.       "profile_sidebar_fill_color":"c7e0ff",
  21.       "notifications":false,
  22.       "utc_offset":-28800,
  23.       "profile_image_url_https":"https:\/\/si0.twimg.com\/profile_images\/24229162\/arne001_normal.jpg",
  24.       "description":"Developer Advocate at Twitter, practitioner of dark sandwich arts. ",
  25.       "display_url":"roomanna.com",
  26.       "following":false,
  27.       "verified":false,
  28.       "favourites_count":190,
  29.       "profile_sidebar_border_color":"6baeff",
  30.       "followers_count":1705,
  31.       "profile_image_url":"http:\/\/a2.twimg.com\/profile_images\/24229162\/arne001_normal.jpg",
  32.       "default_profile_image":false,
  33.       "contributors_enabled":false,
  34.       "deactivated_bit":false,
  35.       "statuses_count":1935,
  36.       "profile_use_background_image":true,
  37.       "location":"Scan Francesco",
  38.       "id_str":"7588892",
  39.       "show_all_inline_media":false,
  40.       "profile_text_color":"000000",
  41.       "screen_name":"kurrik",
  42.       "follow_request_sent":false,
  43.       "profile_background_image_url":"http:\/\/a2.twimg.com\/profile_background_images\/342542280\/background7.png",
  44.       "url":"http:\/\/t.co\/SSiVavc4",
  45.       "expanded_url":"http:\/\/roomanna.com",
  46.       "is_translator":false,
  47.       "time_zone":"Pacific Time (US & Canada)",
  48.       "profile_link_color":"0084B4",
  49.       "id":7588892,
  50.       "entities":{
  51.          "urls":[
  52.  
  53.          ],
  54.          "user_mentions":[
  55.  
  56.          ],
  57.          "hashtags":[
  58.  
  59.          ]
  60.       },
  61.       "suspended":false,
  62.       "lang":"en"
  63.    },
  64.    "member_count":0,
  65.    "id_str":"58300198",
  66.    "subscriber_count":0,
  67.    "id":58300198,
  68.    "uri":"\/kurrik\/goonies"
  69. }