POST friendships/destroy
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

https://api.x.com/1.1/friendships/destroy.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 to unfollow. twitterdev
user_id optional The ID of the user to unfollow. 2244994945

Example Request

POST https://api.x.com/1.1/friendships/destroy.json?user_id=2244994945

Example Response

{user-object,
  "status": {tweet-object}
}

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