POST friendships/update

Enable or disable Retweets and device notifications from the specified user.

Resource URL

https://api.twitter.com/1.1/friendships/update.json

Resource Information

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

Parameters

Name Required Description Default Value Example
screen_name optional The screen name of the user being followed. twitterdev
user_id optional The ID of the user being followed. 2244994945
device optional Enable/disable device notifications from the target user. true
retweets optional Enable/disable Retweets from the target user. false

Example Request

twurl -X POST /1.1/friendships/update.json?user_id=2244994945

Example Response

{
  "relationship": {
    "source": {
      "id": 63046977,
      "id_str": "63046977",
      "screen_name": "happycamper",
      "following": true,
      "followed_by": false,
      "live_following": false,
      "following_received": null,
      "following_requested": false,
      "notifications_enabled": false,
      "can_dm": false,
      "blocking": false,
      "blocked_by": false,
      "muting": false,
      "want_retweets": true,
      "all_replies": false,
      "marked_spam": false
    },
    "target": {
      "id": 2244994945,
      "id_str": "2244994945",
      "screen_name": "TwitterDev",
      "following": false,
      "followed_by": true,
      "following_received": false,
      "following_requested": null
    }
  }
}

Was this document helpful?

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.