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:WebSocket Message Format
All WebSocket messages are JSON with atype field:
Available Endpoints
WebSocket Endpoints
Glasses Connection
/glasses-ws - Mobile app connectionsApp Connection
/app-ws - Third-party app connectionsREST 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?
- Check the SDK documentation
- Join our Discord community
- View example implementations