POST friendships/update

Turn on/off 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 Turn on/off device notifications from the target user. true
retweets optional Turn on/off 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

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.