Skip to main content
DELETE
/
2
/
users
/
{id}
/
likes
/
{tweet_id}
Unlike Post
curl --request DELETE \
  --url https://api.x.com/2/users/{id}/likes/{tweet_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "liked": true
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

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

Example:

"2244994945"

​
tweet_id
string
required

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

Pattern: ^[0-9]{1,19}$
Example:

"1346889436626259968"

Response

The request has succeeded.

​
data
object
​
errors
object[]
Minimum array length: 1

An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).