Skip to main content

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.

This guide walks you through hiding and unhiding replies to Posts in conversations you started.
PrerequisitesBefore you begin, you’ll need:
  • A developer account with an approved App
  • User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

​
Hide a reply

Find the reply's Post ID

Get the ID of the reply you want to hide. You can only hide replies to conversations started by the authenticated user.
https://x.com/user/status/1232720193182412800
                          └── This is the Post ID

Send the hide request

cURL
curl -X PUT "https://api.x.com/2/tweets/1232720193182412800/hidden" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"hidden": true}'

Confirm the reply is hidden

{
  "data": {
    "hidden": true
  }
}
The reply is now hidden from the main conversation view. Users can still see it by clicking “View hidden replies.”

​
Unhide a reply

To make a hidden reply visible again:
cURL
curl -X PUT "https://api.x.com/2/tweets/1232720193182412800/hidden" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"hidden": false}'
Response: 
{
  "data": {
    "hidden": false
  }
}

​
Important notes

  • You can only hide replies to conversations you started
  • Hidden replies are still visible via “View hidden replies”
  • The reply author is not notified when their reply is hidden

​
Next steps

Manage by topic

Moderate replies based on content

Real-time moderation

Moderate replies as they arrive

API Reference

Full endpoint documentation