Skip to main content
User relationship APIs let a signed-in user build and manage their social graph. Use them for follow/unfollow actions, incoming follow requests, follower and following lists, follow counts, and blocked-user management.
For an end-to-end product walkthrough, see User Profiles & Social Graph. This section focuses on SDK calls and return shapes.

​
Relationship Systems

Follow status values are platform-specific enum or string values, but the shared meanings are:
Whether a follow becomes accepted immediately or starts as pending is determined by your network’s follow configuration. The same SDK follow call is used in both cases.

​
Platform Coverage

​
Use The Right Read API

Use the live or paginated APIs for user-facing screens:
  • Follow info: profile headers, follow buttons, counters, and relationship badges.
  • Follower/following lists: people lists with pagination and refresh behavior.
  • Blocked users: a settings screen where users can review and unblock accounts.
Use getAllBlockedUsers() only when you need a one-shot block list for local decisions. It returns up to 100 blocked users on TypeScript, iOS, and Android, and the SDK caches the result briefly.
Do not rely on this overview for feed visibility, search visibility, comment permissions, or other product policy details. Those behaviors can depend on backend configuration and feature area. Handle SDK errors from the affected feature API and keep the UI state in sync with relationship status.

Follow/Unfollow User

Create or remove a follow relationship.

Accept/Decline Follow Request

Approve or reject incoming follow requests.

Get Connection Status

Read follow status and follow counts.

Get Follower/Following List

Query paginated relationship lists.

Block & Unblock User

Block or unblock another user.

Manage Blocked Users

Query the current user’s blocked-user list.

Users Who Blocked You

Query the reverse direction — users who blocked you.