Unfollow User

Causes the authenticated user to unfollow a specific user by their ID.

DELETE /2/users/{source_user_id}/following/{target_user_id}

Try it

Unfollow User

cURL

curl --request DELETE \
  --url https://api.x.com/2/users/{source_user_id}/following/{target_user_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "following": true
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

source_user_id · string · required

The ID of the authenticated source User that is requesting to unfollow the target User. Unique identifier of this User. The value must be the same as the authenticated user.

Example:

"2244994945"

target_user_id · string · required

The ID of the User that the source User is requesting to unfollow. Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Example:

"2244994945"

Response

200

application/json

The request has succeeded.

data · object

Show child attributes

data. following · boolean

errors · object[]

Minimum array length: 1

Show child attributes

errors. title · string · required

errors. type · string · required

errors. detail · string

errors. status · integer