Skip to main content
The follows module reads a user’s follow graph — the users they follow and the users following them — and removes follow relationships by ID.
Every function acts on behalf of a named user. Pass that user’s Sublay ID as userId — the returned graph and counts are from that user’s perspective.
To create a follow (or unfollow by target user ID, or check follow status), use the nested routes on the users module (createFollow, deleteFollow, fetchFollowStatus), which take an actingUserId.

​
fetchFollowing

Returns a paginated list of the follow records for users the given user follows. 
const { data, pagination } = await sublay.follows.fetchFollowing({
  userId: "usr_abc123",
  page: 1,
  limit: 20,
});
​
userId
string
required
The Sublay user ID whose following list to fetch.
​
page
number
Page number (1-indexed). Defaults to 1.
​
limit
number
Results per page. Defaults to 20.
Returns — Promise<PaginatedResponse<Follow>>

​
fetchFollowers

Returns a paginated list of the follow records for users that follow the given user. 
const { data, pagination } = await sublay.follows.fetchFollowers({
  userId: "usr_abc123",
  page: 1,
  limit: 20,
});
​
userId
string
required
The Sublay user ID whose followers list to fetch.
​
page
number
Page number (1-indexed). Defaults to 1.
​
limit
number
Results per page. Defaults to 20.
Returns — Promise<PaginatedResponse<Follow>>

​
fetchFollowingCount

Returns the number of users the given user follows. 
const { count } = await sublay.follows.fetchFollowingCount({
  userId: "usr_abc123",
});
​
userId
string
required
The Sublay user ID.
Returns — Promise<{ count: number }>

​
fetchFollowersCount

Returns the number of users following the given user. 
const { count } = await sublay.follows.fetchFollowersCount({
  userId: "usr_abc123",
});
​
userId
string
required
The Sublay user ID.
Returns — Promise<{ count: number }>

​
deleteFollow

Deletes a follow relationship by its follow record ID. 
await sublay.follows.deleteFollow({
  followId: "fol_xyz789",
  userId: "usr_abc123",
});
​
followId
string
required
The ID of the follow record to delete.
​
userId
string
required
The Sublay user ID on whose behalf the follow is removed (must be the follower).
Returns — Promise<void>