PUT /2/tweets/:id/hidden

Hides or unhides a reply to a Tweet.

Endpoint URL

https://api.twitter.com/2/tweets/:id/hidden

Authentication and rate limits

Authentication methods supported by this endpoint	OAuth 1.0a User context
Rate limit	50 requests per 15-minute window (user auth)

Learn more about rate limits.

Path parameters

Name	Type	Description
`id` Required	string	Unique identifier of the Tweet to hide or unhide. The Tweet must belong to a conversation initiated by the authenticating user.

JSON body parameters

Name	Type	Description
`hidden` Required	boolean	Indicates the action to perform. Specify `true` to hide the Tweet, `false` to unhide. Trying to hide a Tweet that's already hidden (or unhide a Tweet that is not hidden) will result in a successful call.

Example requests

cURL (hide reply)
twurl (hide reply)
cURL (unhide reply)
twurl (unhide reply)

      curl -XPUT 'https://api.twitter.com/2/tweets/:id/hidden' 
-H "Authorization: OAuth $USER_CONTEXT_SIGNATURE" 
-H "Content-type: application/json" 
-d '{"hidden": true}'

      twurl -XPUT '/2/tweets/:id/hidden' 
-A "Content-Type: application/json" 
-d '{"hidden": true}'

      curl -XPUT 'https://api.twitter.com/2/tweets/:id/hidden' 
-H "Authorization: OAuth $USER_CONTEXT_SIGNATURE" 
-H "Content-type: application/json" 
-d '{"hidden": false}'

      twurl -XPUT '/2/tweets/:id/hidden' 
-A "Content-Type: application/json" 
-d '{"hidden": false}'

Example responses

      {
  "data": {
    "hidden": true
  }
}

      {
  "data": {
    "hidden": false
  }
}

Response fields

Name	Type	Description
`hidden`	boolean	Indicates if the Tweet was successfully hidden or unhidden.

Was this document helpful?

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

This page is missing information.

The information was hard to follow or confusing.

There is inaccurate information.

There is a broken link or typo.

Specific Feedback

Thank you for the feedback. Your comments will help us improve our documents in the future.