POST direct_messages/destroy

Destroys the direct message specified in the required ID parameter. The authenticating user must be the recipient of the specified direct message.

Important: This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.

Resource URL

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

Resource Information

Response formats
JSON
Requires authentication?
Yes (user context only)
Rate limited?
Yes

Parameters

id required

The ID of the direct message to delete.

Example Values: 1270516771

include_entities optional

The entities node will not be included when set to false.

Example Values: false

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

POST
https://api.twitter.com/1.1/direct_messages/destroy.json?id=240251665733795841

Example Result


{
    "created_at": "Tue Aug 28 00:57:15 +0000 2012", 
    "entities": {
        "hashtags": [], 
        "urls": [], 
        "user_mentions": []
    }, 
    "id": 240251665733795841, 
    "id_str": "240251665733795841", 
    "recipient": {
        "contributors_enabled": true, 
        "created_at": "Sat May 09 17:58:22 +0000 2009", 
        "default_profile": false, 
        "default_profile_image": false, 
        "description": "I taught your phone that thing you like.  The Mobile Partner Engineer @Twitter. ", 
        "favourites_count": 584, 
        "follow_request_sent": false, 
        "followers_count": 10622, 
        "following": true, 
        "friends_count": 1181, 
        "geo_enabled": true, 
        "id": 38895958, 
        "id_str": "38895958", 
        "is_translator": false, 
        "lang": "en", 
        "listed_count": 190, 
        "location": "San Francisco", 
        "name": "Sean Cook", 
        "notifications": false, 
        "profile_background_color": "1A1B1F", 
        "profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png", 
        "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png", 
        "profile_background_tile": true, 
        "profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", 
        "profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG", 
        "profile_link_color": "2FC2EF", 
        "profile_sidebar_border_color": "181A1E", 
        "profile_sidebar_fill_color": "252429", 
        "profile_text_color": "666666", 
        "profile_use_background_image": true, 
        "protected": false, 
        "screen_name": "theSeanCook", 
        "show_all_inline_media": true, 
        "statuses_count": 2608, 
        "time_zone": "Pacific Time (US & Canada)", 
        "url": null, 
        "utc_offset": -28800, 
        "verified": false
    }, 
    "recipient_id": 38895958, 
    "recipient_screen_name": "theSeanCook", 
    "sender": {
        "contributors_enabled": false, 
        "created_at": "Thu Aug 23 19:45:07 +0000 2012", 
        "default_profile": false, 
        "default_profile_image": false, 
        "description": "Keep calm and test", 
        "favourites_count": 0, 
        "follow_request_sent": false, 
        "followers_count": 0, 
        "following": false, 
        "friends_count": 11, 
        "geo_enabled": true, 
        "id": 776627022, 
        "id_str": "776627022", 
        "is_translator": false, 
        "lang": "en", 
        "listed_count": 0, 
        "location": "San Francisco, CA", 
        "name": "Mick Jagger", 
        "notifications": false, 
        "profile_background_color": "000000", 
        "profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", 
        "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg", 
        "profile_background_tile": true, 
        "profile_image_url": "http://a0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", 
        "profile_image_url_https": "https://si0.twimg.com/profile_images/2550256790/hv5rtkvistn50nvcuydl_normal.jpeg", 
        "profile_link_color": "000000", 
        "profile_sidebar_border_color": "000000", 
        "profile_sidebar_fill_color": "000000", 
        "profile_text_color": "000000", 
        "profile_use_background_image": false, 
        "protected": false, 
        "screen_name": "s0c1alm3dia", 
        "show_all_inline_media": false, 
        "statuses_count": 0, 
        "time_zone": "Pacific Time (US & Canada)", 
        "url": "http://cnn.com", 
        "utc_offset": -28800, 
        "verified": false
    }, 
    "sender_id": 776627022, 
    "sender_screen_name": "s0c1alm3dia", 
    "text": "hello, tworld."
}