POST friendships/update

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

Resource URL

Resource Information

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


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

Example Request


Example Response

  "relationship": {
    "target": {
      "id_str": "1401881",
      "id": 1401881,
      "followed_by": true,
      "screen_name": "dougw",
      "following": true
    "source": {
      "can_dm": true,
      "blocking": false,
      "id_str": "819797",
      "all_replies": false,
      "want_retweets": true,
      "id": 819797,
      "marked_spam": false,
      "followed_by": true,
      "notifications_enabled": true,
      "screen_name": "episod",
      "following": true