Guides

Mutes, Blocks, and Bans

Hide users and their activity based on user or developer preference

Suggest Edits

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 Warpcast 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 Warpcast.

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 and blocks 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/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 and blocks to the fid provided.

/v2/farcaster/notifications  
/v2/farcaster/notifications/channel  
/v2/farcaster/notifications/parent_url

Updated 2 days ago