POST favorites/destroy

Un-favorites the status specified in the ID parameter as the authenticating user. Returns the un-favorited status in the requested format when successful.

This process invoked by this method is asynchronous. The immediately returned status may not indicate the resultant favorited status of the tweet. A 200 OK response from this method will indicate whether the intended action was successful or not.

Resource URL

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

Resource Information

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

Parameters

Name Required Description Default Value Example
id required The numerical ID of the desired status.   123
include_entities optional The entities node will be omitted when set to false .   false

Example Request

POST https://api.twitter.com/1.1/favorites/destroy.json?id=243138128959913986

Example Response

{
  "contributors": null,
  "coordinates": null,
  "created_at": "Wed Sep 05 00:07:01 +0000 2012",
  "entities": {
    "hashtags": [],
    "urls": [],
    "user_mentions": []
  },
  "favorited": false,
  "geo": null,
  "id": 243138128959913986,
  "id_str": "243138128959913986",
  "in_reply_to_screen_name": null,
  "in_reply_to_status_id": null,
  "in_reply_to_status_id_str": null,
  "in_reply_to_user_id": null,
  "in_reply_to_user_id_str": null,
  "place": null,
  "retweet_count": 0,
  "retweeted": false,
  "source": "Twitter for Mac",
  "text": "That feel when you accidentally type Bash commands into Campfire, and you also make a typo in them.",
  "truncated": false,
  "user": {
    "contributors_enabled": false,
    "created_at": "Wed Apr 23 20:32:35 +0000 2008",
    "default_profile": false,
    "default_profile_image": false,
    "description": "Developer at GitHub in San Francisco, CA.\r\n\r\nChicken nuggets is like my family.",
    "entities": {
      "description": {
        "urls": []
      },
      "url": {
        "urls": [
          {
            "display_url": null,
            "expanded_url": null,
            "indices": [
              0,
              21
            ],
            "url": "http://jakeboxer.com/"
          }
        ]
      }
    },
    "favourites_count": 187,
    "follow_request_sent": false,
    "followers_count": 714,
    "following": false,
    "friends_count": 327,
    "geo_enabled": true,
    "id": 14500363,
    "id_str": "14500363",
    "is_translator": false,
    "lang": "en",
    "listed_count": 39,
    "location": "San Francisco, CA",
    "name": "Jake Boxer",
    "notifications": false,
    "profile_background_color": "352726",
    "profile_background_image_url": "http://a0.twimg.com/images/themes/theme5/bg.gif",
    "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme5/bg.gif",
    "profile_background_tile": false,
    "profile_image_url": "http://a0.twimg.com/profile_images/1621757700/twitter_normal.png",
    "profile_image_url_https": "https://si0.twimg.com/profile_images/1621757700/twitter_normal.png",
    "profile_link_color": "D02B55",
    "profile_sidebar_border_color": "829D5E",
    "profile_sidebar_fill_color": "99CC33",
    "profile_text_color": "3E4415",
    "profile_use_background_image": true,
    "protected": false,
    "screen_name": "jake_boxer",
    "show_all_inline_media": false,
    "statuses_count": 5398,
    "time_zone": "Eastern Time (US & Canada)",
    "url": "http://jakeboxer.com/",
    "utc_offset": -18000,
    "verified": false
  }
}