Changing Feed Visibility

Changing Feed Visibility

Visibility changes are asynchronous. The API returns optimistically, then reconciles follow relationships in the background.

This is the only way to change the visibility of a feed that already exists. A feed group's default_visibility is applied at feed creation, so changing it affects new feeds only and leaves existing feeds on the level they were created with.

How transitions behave

Tightening visibility (for example visible -> members or private):

  • Users who no longer qualify are unfollowed automatically.
  • Tightening to members keeps member follows and owner follow.
  • Tightening to private keeps only owner follow.

Loosening visibility from followers (for example followers -> visible):

  • Pending follow requests are processed by pending_follows_action:
    • auto_approve (default)
    • reject
  • pending_follows_action is only used when transitioning away from followers.

Examples

Feed feed = new Feed("user", "jack", feedsClient);

feed.changeFeedVisibility(
    ChangeFeedVisibilityRequest.builder()
        .visibility("followers")
        .build());

feed.changeFeedVisibility(
    ChangeFeedVisibilityRequest.builder()
        .visibility("visible")
        .pendingFollowsAction("auto_approve")
        .build());