​
Mutes

When Alice mutes Bob:
  • All of Bob’s casts, likes, replies, and recasts are hidden from Alice in feeds, search, and reaction APIs when Alice’s viewer_fid is specified. See the full list of endpoints below.
  • Notifications from Bob are hidden when fetching notifications for Alice.
  • Bob can still view and interact with Alice’s casts.
Mutes can be created or deleted via our allowlisted Mute APIs. Note that Neynar mutes are separate from Farcaster mutes. Mute’s are private – they are not explicitly disclosed by any of our APIs.

​
Blocks

When Alice blocks Bob:
  • Bob’s casts, likes, replies, and recasts are hidden from Alice – and vice versa – when either user’sviewer_fid is provided.
  • Both users are always hidden from each other in the Notifications based on the provided fid.
Blocks are public and can be listed, created, and deleted via our block list. Blocks are part of the Farcaster protocol and synced with the Farcaster app.

​
Bans

A user can be banned from a client at the discretion of the app owner. This will hide that user’s account and all of their activity in the endpoints listed below for all API calls made from that app’s API key. Bans are only viewable by the app owner, and can be listed, created, and deleted via our Ban APIs.

​
List of Endpoints

The endpoints listed below respect mutes, blocks and bans. For these endpoints, the mutes, blocks and bans apply to the optional viewer_fid provided. 
/v2/farcaster/following
/v2/farcaster/cast/conversation
/v2/farcaster/feed/channels
/v2/farcaster/feed/following
/v2/farcaster/feed/for_you
/v2/farcaster/feed/frames
/v2/farcaster/feed
/v2/farcaster/feed/parent_urls
/v2/farcaster/feed/trending
/v2/farcaster/feed/users/replies_and_recasts
/v2/farcaster/followers
/v2/farcaster/followers/relevant
/v2/farcaster/reactions/cast
/v2/farcaster/reactions/user
/v2/farcaster/cast/search
/v2/farcaster/user/search
/v2/farcaster/channel/followers
/v2/farcaster/channel/followers/relevant
These endpoints apply mutes, blocks and bans to the fid provided. 
/v2/farcaster/notifications
/v2/farcaster/notifications/channel
/v2/farcaster/notifications/parent_url