API Reference

Complete REST API documentation

The OCVR API is a REST API that provides access to authentication, social features, chat, files, and game assets.

Base URL

https://api.ocvr.net/v1

Authentication

Most endpoints require authentication via Bearer token:

Authorization: Bearer sess_abc123...

Response Format

All responses use a standard envelope:

{
  "data": { ... },
  "error": null
}

Endpoints

Authentication & Users

Endpoint Description
Authentication Login, register, sessions, TOTP
Presence Online status, friends presence

Social

Endpoint Description
Friends Friend requests, friendships
Blocks Block and unblock users
Notifications In-app notifications

Communication

Endpoint Description
Chat Channels, messages, reactions, typing
Tags Personal message tagging

Content

Endpoint Description
Files File storage, folders, sharing, quota
Uploads Presigned upload flow
Media Avatars and custom emotes
Game Assets Worlds, avatars, props with versioning

Rate Limits

Endpoint Limit
/v1/auth/register 5/hour per IP
/v1/auth/login 10/min per IP
Other endpoints 100/min per user
-- ---