API reference
API reference
Select your platform
No SDKs available
No versions available

Users

Updated: Oct 1, 2025

Users

class Users
This class provides methods to access information about the horizon.platform.users.models.User. It allows you to retrieve a user’s ID, access token, and org-scoped ID, as well as their friends list and recently met users. Additionally, it provides methods to launch various flows such as blocking, unblocking, reporting, and sending friend requests. It’s useful when you need to manage user relationships or perform actions that require user authentication within your application.

Constructors

NameSummary
Users
constructor()

Types

NameSummary
Companion
object Companion

Functions

NameSummary
cancelRecordingForReportFlow
suspend fun cancelRecordingForReportFlow(recordingUuid: String)
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
get
suspend fun get(userId: String): User
Retrieve the user with the given ID. This might fail if the ID is invalid or the user is blocked. NOTE: Users will have a unique ID per application.
getAccessToken
suspend fun getAccessToken(): String
Return an access token string for this user, suitable for making REST calls against graph.oculus.com.
getBlockedUsers
fun getBlockedUsers(coroutineScope: CoroutineScope): PagedResults<BlockedUser>
Return the IDs of users entitled to use the current app that are blocked by the specified user
getLinkedAccounts
suspend fun getLinkedAccounts(userOptions: UserOptions): List<LinkedAccount>
Returns a list of linked accounts that are associated with the specified service providers. Customization can be done via UserOptions. Create this object with horizon.platform.users.options.UserOptions. The params that could be used are:
getLoggedInUser
suspend fun getLoggedInUser(): User
Retrieve the currently signed in user. This call is available offline. NOTE: This will not return the user’s presence as it should always be ‘online’ in your application. NOTE: Users will have a unique ID per application.
getLoggedInUserFriends
fun getLoggedInUserFriends(coroutineScope: CoroutineScope): PagedResults<User>
Retrieve a list of the logged in user’s bidirectional followers. The payload type will be an array of horizon.platform.users.models.User
getLoggedInUserManagedInfo
suspend fun getLoggedInUserManagedInfo(): User
Retrieve the currently signed in user’s managed info. This call is not available offline. NOTE: This will return data only if the logged in user is a managed Meta account (MMA).
getOrgScopedId
suspend fun getOrgScopedId(userId: String): OrgScopedID
returns an ovrID which is unique per Developer Dashboard team. Allows different apps within the same org to identify the user.
getSdkAccounts
suspend fun getSdkAccounts(): List<SdkAccount>
Returns all accounts belonging to this user. Accounts are the Oculus user and x-users that are linked to this user.
getUserCapabilities
suspend fun getUserCapabilities(): List<UserCapability>
Fetches all the horizon.platform.users.models.UserCapability for the logged-in user
getUserProof
suspend fun getUserProof(): UserProof
Part of the scheme to confirm the identity of a particular user in your backend. You can pass the result of horizon.platform.users.Users.getUserProof and a user ID from horizon.platform.users.models.User.id to your backend. Your server can then use our api to verify identity. ‘https://graph.oculus.com/user_nonce_validate?nonce=USER_PROOF&user_id=USER_ID&access_token=ACCESS_TOKEN’ NOTE: The nonce is only good for one check and then it is invalidated.
launchBlockFlow
suspend fun launchBlockFlow(userId: String): LaunchBlockFlowResult
Launch the flow for blocking the given user. You can’t follow, be followed, invited, or searched by a blocked user, for example. You can remove the block via ovr_User_LaunchUnblockFlow.
launchFriendRequestFlow
suspend fun launchFriendRequestFlow(userId: String): LaunchFriendRequestFlowResult
Launch the flow for sending a follow request to a user.
launchReportFlow
suspend fun launchReportFlow(userId: String): UserReportID
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
launchReportFlow2
suspend fun launchReportFlow2(optionalUserId: Long, abuseReportOptions: AbuseReportOptions? = null): LaunchReportFlowResult
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
launchUnblockFlow
suspend fun launchUnblockFlow(userId: String): LaunchUnblockFlowResult
Launch the flow for unblocking a user that the viewer has blocked.
newEntitledTestUser
suspend fun newEntitledTestUser(): String
Return a new test user, as above, that is entitled to all of the app’s IAP items.
newTestUser
suspend fun newTestUser(): String
Return a new omni test user on a temporary db. Because these are transient, these users will eventually be automatically cleaned up. These users should only be used in tests.
newTestUserFriends
suspend fun newTestUserFriends(): String
Return an array of omni test user on a temporary db. Because these are transient, these users will eventually be automatically cleaned up. These users should only be used in tests. These two users are friends.
startRecordingForReportFlow
suspend fun startRecordingForReportFlow(): AbuseReportRecording
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
stopRecordingAndLaunchReportFlow
suspend fun stopRecordingAndLaunchReportFlow(optionalUserId: Long, optionalRecordingUuid: String): UserReportID
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
stopRecordingAndLaunchReportFlow2
suspend fun stopRecordingAndLaunchReportFlow2(optionalUserId: Long, optionalRecordingUuid: String, abuseReportOptions: AbuseReportOptions? = null): UserReportID
The API has been deprecated. Please use AbuseReport.launch_advanced_report_flow() instead.
testUserCreateDeviceManifest
suspend fun testUserCreateDeviceManifest(deviceId: String, appIds: List<String>, numAppIds: Int)
Takes a previously created test user and creates a device manifest with the given set of apps installed.

Companion

object Companion
Did you find this page helpful?
Thumbs up icon
Thumbs down icon