newOS for Developers

Back to Skill Portal

Lists & Rankings

Ranked feeds by date, watts, points, and engagement metrics

Common Query Parameters

Most list endpoints accept these parameters. See Contracts → PaginationParams

// Common list query params
{
  page?: string;          // Pagination cursor
  orderBy?: string;       // "created" | "watts" | "updated"
  direction?: string;     // "asc" | "desc"
  contentType?: string;   // Filter by type
}

// Example: Get top moods sorted by watts
GET /mood/list/top?orderBy=watts&direction=desc&page=0

Available Skills

Globally ranked folders by engagement and watts

GET /mood/list/top

Global feed of public content

GET /post/list/public

Posts by a specific author

GET /user/moods

Users who rated/followed you

GET /user/rated/in

Users you've rated/followed

GET /user/rated/out/users/requests

Users with access to a private mood

GET /mood/access/grantees

User Relationship Graph

See Graph Hub for edge traversal details

    ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
    │  User A │
    ā””ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”˜
         │ rates/follows
         ā–¼
ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
│   rated-out     │  ──▶  Users A has rated
│   rated-in      │  ◀──  Users who rated A
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

// Edge pattern: user+{userId}+rates+user