New REST API endpoints for Mute functionality

andypiper · 2014-05-12T17:20:29.000Z

Hi Developers,

We’re happy to announce that several new API endpoints are available to you, working with the new Mute feature.

The Mute API endpoints are somewhat analogous to the /blocks/ methods already available, but have quite different results. The function enables a particular user to be “muted” from the timelines of the authenticating user, rather than unfollowing or blocking them.

To mute or unmute a user you would use the POST mutes/users/create and POST mutes/users/destroy endpoints respectively. To find out whether an authenticated user is muting other users you can use the GET mutes/users/ids and GET mute/users/list endpoints. In addition, GET friendships/show and GET friendships/lookup will also now include information about whether one user is muting another. Some new error responses specific to mute have been added to Error Codes & Responses.

The Twitter web and mobile clients are starting to support this new feature, and we are excited to share these new API endpoints with the developer community for use in your own apps and tools.

We’re rolling this change out to users this week, so please try the endpoint within a few days if you do not initially have access. User-facing support information can be found on the Help Center https://support.twitter.com/articles/20171399

tapbot_paul · 2014-05-12T18:05:02.000Z

What impact, if any, will mutes have on site/user streams?

graysky · 2014-05-12T18:21:03.000Z

Looks like those documentation pages are still private, I get Access Denied.

Will the tweets be filtered API-side or just decorated in the status itself?

andypiper · 2014-05-12T21:51:00.000Z

currently this is a REST API feature. I will check on the impact on streams and update if there are any changes.

andypiper · 2014-05-12T21:52:00.000Z

Hopefully the docs are showing up for you now?

the tweets are filtered out/muted within the timeline i.e. API side.

dennisl · 2014-05-13T05:02:04.000Z

Not getting the muting info from the friendships call.

artesea · 2014-05-13T08:51:31.000Z

Having similar gaps in returned data.
I was able to successfully mute someone I was following but nothing was returned in either friendships/show or in the user object within statuses/user_timeline to allow me to highlight people to unmute them.
I did find muting in friendships/lookup but it seems unnecessary to make a third api call.

andypiper · 2014-05-13T11:07:00.000Z

This is being rolled out through this week so you should start to see the info (which is just the one additional “muting” field) returned shortly.

andypiper · 2014-05-13T11:09:54.000Z

You’ll currently get the muting field in the User objects returned from the mutes API calls, and in friendships/show. I’ll clarify with the team whether we should expect to see it in all instances of the User object like statuses/user_timeline.

artesea · 2014-05-13T11:27:12.000Z

I’d expect a cached user object in statuses/user_timeline so it’s not a huge problem if it wasn’t there. Just not seeing it at all in friendships/show will wait a week before pushing the code live.

MadhuGowthaman · 2014-05-13T13:09:02.000Z

I get access denied for those documentation pages.

talkingfrog1950 · 2014-05-13T14:44:41.000Z

Still locked out as well

talkingfrog1950 · 2014-05-13T14:46:09.000Z

Will mute prevent receipt of retweets of muted users?

andypiper · 2014-05-13T15:41:27.000Z

sorry! caching issue… should (!) be sorted now.

andypiper · 2014-05-13T15:42:00.000Z

mute will filter tweets from a user from your home and mentions timelines. It will not stop someone else retweeting them and having that show up in one of those timelines.

dekisu · 2014-05-13T18:31:00.000Z

"the tweets are filtered out/muted within the timeline i.e. API side. "

I’m not sure if i’m interpreting this correctly, does this mean we don’t need to grab a list of muted users manually just like we do with blocked users to filter them client-side? (as mentioned in https://dev.twitter.com/docs/streaming-apis/streams/user ). So, for some reason streams can exclude muted users, but can’t exclude blocked ones? I’m probably wrong, since the other announcement seems to suggest this is a client-side feature.

andypiper · 2014-05-13T21:52:14.000Z

this is not a streaming API feature at this stage, REST API only.

richardhyland · 2014-05-14T08:20:54.000Z

Does an event fire in user or site streams when a mute is created or destroyed so that we can automatically add a mute without calling the REST API for updates?

andypiper · 2014-05-14T12:18:27.000Z

not at present. We are looking at features around mutes and streams for a future revision.

artesea · 2014-05-16T12:15:00.000Z

I know it’s not a week but still nothing in friendships/show apigee snapshot of someone who is currently muted
https://snap.apigee.com/1owJRjq