DELETE /2/users/:id/likes/:tweet_id

DELETE /2/users/:id/likes/:tweet_id

Allows a user or authenticated user ID to unlike a Tweet.

The request succeeds with no action when the user sends a request to a user they're not liking the Tweet or have already unliked the Tweet.



Endpoint URL

https://api.x.com/2/users/:id/likes/:tweet_id

Authentication and rate limits

Authentication methods
supported by this endpoint

OAuth 1.0a User context

Rate limit

User rate limit: 50 requests per 15-minute window

User rate limit: 1000 requests per 24-hour window
(Shared with POST /2/users/:id/likes)

Path parameters

Name Type Description
id
 Required 
string The user ID who you are removing a Like of a Tweet on behalf of. It must match your own user ID or that of an authenticating user, meaning that you must pass the Access Tokens associated with the user ID when authenticating your request.
tweet_id
 Required 
string The ID of the Tweet that you would like the id to unlike.



Example requests

cURL
twurl
      curl -X DELETE https://api.x.com/2/users/2244994945/likes/1228393702244134912 -H "Authorization: OAuth $OAUTH_SIGNATURE"
    
      twurl -X DELETE /2/users/2244994945/likes/1228393702244134912

    

Example responses

Successful response
      {
  "data": {
    "liked": false
  }
}
    

Response fields

NameTypeDescription
likedbooleanIndicates whether the user is unliking the specified Tweet as a result of this request. The returned value is false for a successful unlike request.