Skip to main content

Overview

MentraOS Cloud provides both WebSocket and REST APIs:

WebSocket APIs

Real-time bidirectional communication for glasses and apps

REST APIs

HTTP endpoints for authentication, management, and configuration

Base URLs

Authentication

WebSocket Authentication

WebSocket connections authenticate using JWT tokens in the Authorization header:

REST API Authentication

REST endpoints use Bearer token authentication:

Rate Limits

API rate limits apply per user:
  • REST API: 100 requests per minute
  • WebSocket messages: 50 per second
  • Display updates: 1 per 200ms

Response Format

All REST API responses follow this format:
Error responses:

WebSocket Message Format

All WebSocket messages are JSON with a type field:

Available Endpoints

WebSocket Endpoints

Glasses Connection

/glasses-ws - Mobile app connections

App Connection

/app-ws - Third-party app connections

REST Endpoints

Authentication

Login, token refresh, logout

User Management

Profile, settings, preferences

App Management

Install, uninstall, configure apps

SDK Integration

The MentraOS SDK handles all API communication for you:

Need Help?