Skip to Main Content Area

POST lists/destroy

API version 1.1

Updated on Wed, 2012-09-05 12:36

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

Resource URL

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

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.1/lists/destroy.json`
POST Data	`owner_screen_name=kurrik&slug=goonies`

```
{
```

   "created_at":"Fri Nov 04 21:22:36 +0000 2011",

```
   "slug":"goonies",
```
```
   "name":"Goonies",
```
```
   "full_name":"@kurrik\/goonies",
```
```
   "description":"For life",
```
```
   "mode":"public",
```
```
   "following":false,
```
```
   "user":{
```
```
      "geo_enabled":true,
```

      "profile_background_image_url_https":"https:\/\/si0.twimg.com\/profile_background_images\/342542280\/background7.png",

      "profile_background_color":"8fc1ff",

```
      "protected":false,
```
```
      "default_profile":false,
```
```
      "listed_count":127,
```
```
      "profile_background_tile":true,
```

      "created_at":"Thu Jul 19 15:58:07 +0000 2007",

```
      "friends_count":291,
```
```
      "name":"Arne Roomann-Kurrik",
```

      "profile_sidebar_fill_color":"c7e0ff",

```
      "notifications":false,
```
```
      "utc_offset":-28800,
```

      "profile_image_url_https":"https:\/\/si0.twimg.com\/profile_images\/24229162\/arne001_normal.jpg",

      "description":"Developer Advocate at Twitter, practitioner of dark sandwich arts. ",

```
      "display_url":"roomanna.com",
```
```
      "following":false,
```
```
      "verified":false,
```
```
      "favourites_count":190,
```

      "profile_sidebar_border_color":"6baeff",

```
      "followers_count":1705,
```

      "profile_image_url":"http:\/\/a2.twimg.com\/profile_images\/24229162\/arne001_normal.jpg",

```
      "default_profile_image":false,
```
```
      "contributors_enabled":false,
```
```
      "deactivated_bit":false,
```
```
      "statuses_count":1935,
```

      "profile_use_background_image":true,

```
      "location":"Scan Francesco",
```
```
      "id_str":"7588892",
```
```
      "show_all_inline_media":false,
```
```
      "profile_text_color":"000000",
```
```
      "screen_name":"kurrik",
```
```
      "follow_request_sent":false,
```

      "profile_background_image_url":"http:\/\/a2.twimg.com\/profile_background_images\/342542280\/background7.png",

```
      "url":"http:\/\/t.co\/SSiVavc4",
```

      "expanded_url":"http:\/\/roomanna.com",

```
      "is_translator":false,
```

      "time_zone":"Pacific Time (US & Canada)",

```
      "profile_link_color":"0084B4",
```
```
      "id":7588892,
```
```
      "entities":{
```
```
         "urls":[
```
```
 
```
```
         ],
```
```
         "user_mentions":[
```
```
 
```
```
         ],
```
```
         "hashtags":[
```
```
 
```
```
         ]
```
```
      },
```
```
      "suspended":false,
```
```
      "lang":"en"
```
```
   },
```
```
   "member_count":0,
```
```
   "id_str":"58300198",
```
```
   "subscriber_count":0,
```
```
   "id":58300198,
```
```
   "uri":"\/kurrik\/goonies"
```
```
}
```