Fetch following by user ID

Fetch the following list for any user by their ID

Overview

Returns a function that fetches the paginated list of users that a given user follows, identified by userId. This is a public endpoint — authentication is not required.

For fetching your own following list, see useFetchFollowing.

Usage Example

import { useFetchFollowingByUserId } from "@sublay/react-js";

function UserFollowing({ userId }: { userId: string }) {
  const fetchFollowingByUserId = useFetchFollowingByUserId();
  const [following, setFollowing] = useState([]);

  useEffect(() => {
    fetchFollowingByUserId({ userId, page: 1 }).then((res) => {
      setFollowing(res.data);
    });
  }, [userId]);

  return (
    <ul>
      {following.map(({ followId, user }) => (
        <li key={followId}>{user.name}</li>
      ))}
    </ul>
  );
}

Parameters

The hook returns a function. That function accepts:

userId · string · required

The ID of the user whose following list to fetch.

page · number

Page number to fetch. Defaults to 1.

limit · number

Number of results per page. Defaults to 20.

spaceReputationId · string

Resolves each followed user’s reputation into a spaceReputation number on the embedded user. Accepts a space <uuid> or "none" (project-general bucket) only — "context" is rejected with a 400 on this endpoint. Empty string, "general", and null are also rejected. See Reputation.

spaceReputationDescendants · boolean

When true, spaceReputation is the subtree sum (the space plus all its descendants). Only honored when spaceReputationId is an explicit <uuid>.

Returns

Returns a PaginatedResponse containing an array of following entries:

data · FollowingWithFollowInfo[]

Array of following entries.

Show FollowingWithFollowInfo properties

followId · string

ID of the follow record.

user · User

The followed user’s profile. When spaceReputationId is set, it carries an added spaceReputation number. See User data model and Reputation.

followedAt · string

ISO timestamp of when the follow was created.

pagination · object

Pagination metadata including currentPage, totalPages, totalCount, hasNextPage, and hasPreviousPage.

Related

• useFetchFollowing — fetch the current user’s own following list
• useFetchFollowingCountByUserId — get following count for a user