POST friendships/destroy

POST friendships/destroy

Allows the authenticating user to unfollow the user specified in the ID parameter.

Returns the unfollowed user when successful. Returns a string describing the failure condition when unsuccessful.

Actions taken in this method are asynchronous. Changes will be eventually consistent.

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 to unfollow. twitterdev
user_id optional The ID of the user to unfollow. 2244994945

Example Request


Example Response

  "status": {tweet-object}

For more detail, see the user-object definition and the tweet-object definition.