POST statuses/unretweet/:id

Untweets a retweeted status. Returns the original Tweet with retweet details embedded.

Usage Notes:

  • This method is subject to update limits. A HTTP 429 will be returned if this limit has been hit.
  • The untweeted retweet status ID must be authored by the user backing the authentication token.
  • An application must have write privileges to POST. A HTTP 401 will be returned for read-only applications.
  • When passing a source status ID instead of the retweet status ID a HTTP 200 response will be returned with the same Tweet object but no action.

Resource URL

https://api.twitter.com/1.1/statuses/unretweet/:id.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
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.   true

Example Request

POST https://api.twitter.com/1.1/statuses/retweet/241259202004267009.json

Example Response

{
    "contributors": null,
    "coordinates": null,
    "created_at": "Fri Dec 25 23:11:29 +0000 2015",
    "entities": {
        "hashtags": [],
        "symbols": [],
        "urls": [],
        "user_mentions": [
            {
                "id": "2244994945",
                "id_str": "2244994945",
                "indices": [
                    30,
                    41
                ],
                "name": "TwitterDev",
                "screen_name": "TwitterDev"
            }
        ]
    },
    "favorite_count": 78,
    "favorited": false,
    "geo": null,
    "id": "680526305473867776",
    "id_str": "680526305473867776",
    "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,
    "is_quote_status": false,
    "lang": "en",
    "place": null,
    "retweet_count": 25,
    "retweeted": tweeted,
    "source": "Twitter for iPhone",
    "text": "Happy holidays from all of us @twitterdev! Here's to an exciting 2016!",
    "truncated": false,
    "user": {
        "contributors_enabled": false,
        "created_at": "Sat Dec 14 04:35:55 +0000 2013",
        "default_profile": false,
        "default_profile_image": false,
        "description": "Developer and Platform Relations @Twitter. We are developer advocates. We can't answer all your questions, but we listen to all of them!",
        "entities": {
            "description": {
                "urls": []
            },
            "url": {
                "urls": [
                    {
                      "display_url": "dev.twitter.com",
                      "expanded_url": "https:\/\/dev.twitter.com\/",
                      "indices": [
                          0,
                          23
                      ],
                      "url": "https:\/\/t.co\/66w26cua1O"
                    }
                ]
            }
      },
      "favourites_count": 876,
      "follow_request_sent": false,
      "followers_count": 336055,
      "following": true,
      "friends_count": 1499,
      "geo_enabled": true,
      "has_extended_profile": false,
      "id": 2244994945,
      "id_str": 2244994945,
      "is_translation_enabled": false,
      "is_translator": false,
      "lang": "en",
      "listed_count": 728,
      "location": "Internet",
      "name": "TwitterDev",
      "notifications": false,
      "profile_background_color": "FFFFFF",
      "profile_background_image_url": "http:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png",
      "profile_background_image_url_https": "https:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png",
      "profile_background_tile": false,
      "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/2244994945\/1396995246",
      "profile_image_url": "http:\/\/pbs.twimg.com\/profile_images\/530814764687949824\/npQQVkq8_normal.png",
      "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/530814764687949824\/npQQVkq8_normal.png",
      "profile_link_color": "0084B4",
      "profile_sidebar_border_color": "FFFFFF",
      "profile_sidebar_fill_color": "DDEEF6",
      "profile_text_color": 333333,
      "profile_use_background_image": false,
      "protected": 0,
      "screen_name": "TwitterDev",
      "statuses_count": 1663,
      "time_zone": "Pacific Time (US & Canada)",
      "url": "https:\/\/t.co\/66w26cua1O",
      "utc_offset": "-28800",
      "verified": true
    }
}