The endpoints we release in Labs are previews and are likely to change before they are released broadly, so we encourage you to take that into consideration as you build. Before getting started, we encourage you to read more about Twitter Developer Labs.
 

Frequently Asked Questions

How can I hide replies on behalf of a user? What authentication method is available?

The user needs to authorize your app using a three-legged OAuth flow; this flow will allow your app to hide replies on behalf of the user. Note that this endpoint will only work with OAuth 1.0a user context.
 

How many Tweets can I hide?

While this endpoint is in Labs, your app can hide up to 10 Tweets per 15 minute window, across all the authorized users (there is no limit to the number of users you can authorize). Your app will be able to moderate up to 725 Tweets per conversation.
 

What Tweets can I hide?

You can hide any Tweet in a conversation started by the author who is authenticating with your app. This includes replies, including replies of a reply.
 

What are the Tweets my app cannot hide?

Your app will not be able to hide Retweets (including Retweets with a comment) of a reply. In order to help your app respect the user’s choices, your app will not be able to hide replies who have been unhidden by the user. For the same reason, your app will not be able to hide the author’s original Tweet and any of their replies.
 

I signed up for Labs and activated Hide replies, but I still receive an error when trying to use the API. Why is this happening?

This may happen because your app needs the correct permission level. In your developer dashboard, click the Details button next to the app you connected to the preview named “Hide replies”. Select Permissions, and make sure either “Read and write” or “Read, write, and Direct Messages” is selected.
 

What happens if a user hides or unhides a Tweet from the main Twitter experience?

People can still hide and unhide replies manually. Your implementation must respect the user’s ability to independently change the status of a reply.
 

I’m getting an error while trying to hide a reply, and my app is authenticating on behalf of the author of the original conversation. Why is this happening?

This may happen because:

  • Your app is trying to hide a previously unhidden Tweet. In order to help your app respect the user’s choices, your app will not be able to hide replies who have been unhidden by the user.
  • Your app is trying to hide a Tweet or a reply from the authenticating user.
  • Your app may have reached the rate limit for the current 15-minute time window. In this case, your app can check the response headers to pause making request until the rate limit window resets.
  • The conversation may have reached the maximum allowed number of hidden replies.