Interested in exploring Labs?
The endpoints we release in Labs are previews of tools that may be released more broadly in the future, but will likely undergo changes before then. We encourage you to take that into consideration as you explore. Before getting started, please read more about Twitter Developer Labs.

Still using v1?
This page documents the current version of this endpoints, however you can still reference the previous version. You should also check out our version migration guide and review our changelog.
 

Frequently Asked Questions

How can I hide or unhide 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 or unhide 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 or unhide?

While this endpoint is in Labs, your app can hide or unhide 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 moderate?

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 moderate?

Your app will not be able to hide Retweets (including Retweets with a comment) of a reply. 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 moderate 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 or unhide reply that does not belong to a conversation started by the authenticating user.
  • Your app is trying to hide or unhide a Tweet authored by 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.

 


 

Additional resources

  • Get started building using the examples in the quick start guides
  • Check out our API reference to learn more about what’s available. 
  • Learn more about the new Developer Labs on the "About Labs" page. 
  • Give feedback on Twitter Developer Labs. 
  • Tell us about your experience using the Twitter Developer Labs endpoints by filling out this survey.