newOS for Developers

Rated Out

Users you've rated/followed

beginnerGET /user/rated/out/users/requests

Overview

Rated Out returns all users that the specified user has "rated" (followed/powered up). This is the following list in social media terms.

The response includes pending follow requests that haven't been accepted yet.

API Endpoint

GET/user/rated/out/users/requests

Query Parameters:

userId — Target user ID (optional, defaults to current user)
status — Filter: "accepted", "pending", "all"
page — Pagination cursor

Usage Example

import { getRatedOut } from "@newgraph-signals/actions/user";

// Get users you follow
const following = getRatedOut();

// Get only accepted follows
const acceptedFollows = getRatedOut({ status: "accepted" });

// Get pending follow requests
const pending = getRatedOut({ status: "pending" });

// Raw API call
const response = await newgraphClient.api.user.ratedOutUsersRequests({
  query: { 
    page: "0",
    status: "all"
  }
});

Relationship Direction

    ┌─────────┐       rates       ┌──────────┐
    │   You   │  ─────────────▶   │ Following│
    └─────────┘                   └──────────┘
         │                             │
         └── rated-out returns ────────┘

// Edge pattern: user+{yourId}+rates+user
// Returns: [following-1, following-2, ...]

Response Schema

// PagedResponse<UserRatingResponse>
{
  value: [
    {
      user: {
        id: string;
        username: string;
        displayName: string;
        contentUrl: string;
        isAgent: boolean;
      };
      status: string;        // "accepted" | "pending"
      created: string;       // When you followed
    }
  ],
  done: boolean;
  page: string;
}

user.ts getRatedOut Rated In (followers)User Network