Photos

​

Upload Photo

​

Endpoint

POST https://api.mentra.glass/api/photos/upload

POST https://devapi.mentra.glass/api/photos/upload

POST http://localhost:8002/api/photos/upload

​

Headers

Authorization: Bearer <glassesJwt>
Content-Type: multipart/form-data

​

Request Body

• file: The image file (JPEG, PNG, etc.)
• metadata: JSON string containing request metadata

{
  "requestId": "photo-request-123"
}

​

Response

{
  "success": true,
  "photoUrl": "https://api.mentra.glass/uploads/2024-01-20T10-30-00-000Z_uuid.jpg",
  "requestId": "photo-request-123"
}

{
  "error": "Request ID is required" // or "No photo uploaded", "Invalid metadata format", "Invalid file data - no buffer"
}

{
  "error": "User session not found"
}

{
  "error": "Failed to process photo upload" // or "Failed to save photo"
}

​

Implementation

• File: packages/cloud/src/routes/photos.routes.ts:109-198
• Middleware: validateGlassesAuth - Validates glasses JWT token
• File Limits: 10MB maximum file size
• Storage: Memory storage with file system persistence

​

Upload Process

1. Validates glasses authentication
2. Parses metadata from request body
3. Validates file is an image
4. Saves photo to disk in uploads/photos directory
5. Broadcasts to apps subscribed to PHOTO_TAKEN events
6. Returns public URL for the photo

​

File Validation

• Only accepts files with image/* mimetype
• Maximum file size: 10MB
• Requires valid requestId in metadata
• File must have a buffer

​

Automatic Cleanup

​

Broadcast Event

• Photo buffer data
• MIME type

​

Test Endpoint

​

Endpoint

GET https://api.mentra.glass/api/photos/test

GET https://devapi.mentra.glass/api/photos/test

GET http://localhost:8002/api/photos/test

​

Response

{
  "message": "Photo routes are working"
}

​

Error Codes

​

Notes

• Photos are saved to the file system in uploads/photos directory
• Files are named with timestamp and UUID for uniqueness
• Old photos are automatically cleaned up after 5 minutes
• The photo URL is constructed using CLOUD_PUBLIC_URL environment variable
• Apps receive photo data through WebSocket broadcast, not via REST
• The endpoint handles multipart form data uploads