POST statuses/destroy/:id

Updated on Wed, 2012-04-18 10:39

Destroys the status specified by the required ID parameter. The authenticating user must be the author of the specified status. Returns the destroyed status if successful.

Resource URL

http://api.twitter.com/1/statuses/destroy/:id.format

Parameters

id required

The numerical ID of the desired status.

Example Values: 123

include_entities optional

When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.

Example Values: true

trim_user optional

When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.

Example Values: true

Example Request

POST

http://api.twitter.com/1/statuses/destroy/18976237157.json

POST Data

None

  1. {
  2.   "coordinates": null,
  3.   "truncated": false,
  4.   "created_at": "Tue Jul 20 07:34:26 +0000 2010",
  5.   "favorited": false,
  6.   "entities": {
  7.     "urls": [
  8.  
  9.     ],
  10.     "hashtags": [
  11.  
  12.     ],
  13.     "user_mentions": [
  14.       {
  15.         "name": "Twitter",
  16.         "id": 783214,
  17.         "indices": [
  18.           42,
  19.           50
  20.         ],
  21.         "screen_name": "twitter"
  22.       }
  23.     ]
  24.   },
  25.   "text": "Watching the conversations of the awesome @twitter team as they work through today's issues reminds me why I love this place and the people",
  26.   "contributors": null,
  27.   "annotations": null,
  28.   "id": 18976237157,
  29.   "geo": null,
  30.   "in_reply_to_user_id": null,
  31.   "user": {
  32.     "profile_sidebar_border_color": "C0DEED",
  33.     "name": "Matt Harris",
  34.     "profile_sidebar_fill_color": "DDEEF6",
  35.     "profile_background_tile": false,
  36.     "profile_image_url": "http://a2.twimg.com/profile_images/554181350/matt_normal.jpg",
  37.     "created_at": "Sat Feb 17 20:49:54 +0000 2007",
  38.     "location": "San Francisco",
  39.     "profile_link_color": "0084B4",
  40.     "follow_request_sent": false,
  41.     "contributors_enabled": false,
  42.     "favourites_count": 101,
  43.     "url": "http://themattharris.com",
  44.     "utc_offset": -28800,
  45.     "id": 777925,
  46.     "profile_use_background_image": true,
  47.     "listed_count": 134,
  48.     "followers_count": 1244,
  49.     "protected": false,
  50.     "lang": "en",
  51.     "profile_text_color": "333333",
  52.     "time_zone": "Tijuana",
  53.     "verified": false,
  54.     "geo_enabled": true,
  55.     "profile_background_color": "C0DEED",
  56.     "notifications": false,
  57.     "description": "Developer Advocate at Twitter. Also a hacker and British expat who is married to @cindyli and lives in San Francisco.",
  58.     "statuses_count": 2979,
  59.     "profile_background_image_url": "http://s.twimg.com/a/1279322210/images/themes/theme1/bg.png",
  60.     "friends_count": 306,
  61.     "screen_name": "themattharris",
  62.     "following": true
  63.   },
  64.   "source": "web",
  65.   "in_reply_to_screen_name": null,
  66.   "place": {
  67.     "name": "San Francisco",
  68.     "country_code": "US",
  69.     "country": "The United States of America",
  70.     "attributes": {
  71.  
  72.     },
  73.     "url": "http://api.twitter.com/1/geo/id/5a110d312052166f.json",
  74.     "id": "5a110d312052166f",
  75.     "bounding_box": {
  76.       "coordinates": [
  77.         [
  78.           [
  79.             -122.51368188,
  80.             37.70813196
  81.           ],
  82.           [
  83.             -122.35845384,
  84.             37.70813196
  85.           ],
  86.           [
  87.             -122.35845384,
  88.             37.83245301
  89.           ],
  90.           [
  91.             -122.51368188,
  92.             37.83245301
  93.           ]
  94.         ]
  95.       ],
  96.       "type": "Polygon"
  97.     },
  98.     "full_name": "San Francisco, CA",
  99.     "place_type": "city"
  100.   },
  101.   "in_reply_to_status_id": null
  102. }