Hide replies
API reference contents
PUT /2/tweets/:id/hidden
Hides or unhides a reply to a Tweet.
Endpoint URL
https://api.twitter.com/2/tweets/:id/hiddenAuthentication and rate limits
| Authentication methods supported by this endpoint | |
|---|---|
| Rate limit | 50 requests per 15-minute window (user auth) |
Learn more about rate limits.
Path parameters
| Name | Type | Description |
|---|---|---|
idRequired | 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 |
|---|---|---|
hiddenRequired | 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
- Success (reply hidden)
- Success (reply unhidden)
Response fields
| Name | Type | Description |
|---|---|---|
hidden | boolean | Indicates if the Tweet was successfully hidden or unhidden. |
