Users

Covers the full user lifecycle including registration, authentication, profile management, social features, messaging, personalised recommendations, and account activity. Supports multiple login methods (email, device, phone, social, third-party) and multi-profile accounts.

Identity & Authentication

Register users, manage login sessions, handle token refresh, and verify user identity.

Profiles

Retrieve and update user profile data including display name, avatar, locale, and preferences.

Social & Relationships

Follow and unfollow users and artists, retrieve follower/following lists, and manage social connections.

Messaging

Send and retrieve in-platform messages between users or from the platform to users.

Personalisation & Recommendations

Fetch personalised content recommendations, taste profiles, and discovery signals for the authenticated user.

Account & Activity

Manage account settings, retrieve listening activity, handle account deletion, and audit user events.