Gallery

​

Get Gallery Photos

​

Endpoint

GET https://api.mentra.glass/api/gallery

GET https://devapi.mentra.glass/api/gallery

GET http://localhost:8002/api/gallery

​

Headers

Authorization: Bearer <glassesJwt>

​

Response

{
  "success": true,
  "photos": [
    {
      "_id": "photo-id-123",
      "userId": "user@example.com",
      "userEmail": "user@example.com",
      "filename": "photo_2024_01_20_103000.jpg",
      "uploadedAt": "2024-01-20T10:30:00Z",
      "size": 1048576,
      "mimeType": "image/jpeg",
      "metadata": {
        "requestId": "req-123",
        "origin": "app",
        "packageName": "com.example.app"
      }
    }
  ]
}

{
  "error": "Failed to fetch gallery photos"
}

​

Implementation

• File: packages/cloud/src/routes/gallery.routes.ts:19-37
• Middleware: validateGlassesAuth
• Service: Uses GalleryPhoto.findByUserId() with email from decoded token

​

Delete Gallery Photo

​

Endpoint

DELETE https://api.mentra.glass/api/gallery/:photoId

DELETE https://devapi.mentra.glass/api/gallery/:photoId

DELETE http://localhost:8002/api/gallery/:photoId

​

Headers

Authorization: Bearer <glassesJwt>

​

Parameters

​

Response

{
  "success": true,
  "message": "Photo deleted successfully"
}

{
  "error": "Not authorized to delete this photo"
}

{
  "error": "Photo not found" // or "Failed to delete photo"
}

{
  "error": "Failed to delete photo"
}

​

Implementation

• File: packages/cloud/src/routes/gallery.routes.ts:44-88
• Authorization: Checks that the user owns the photo
• Cleanup: Attempts to delete physical file (non-critical)

​

Deletion Process

1. Validates user authentication
2. Verifies photo exists and user owns it
3. Deletes photo record from database
4. Attempts to delete physical file from uploads directory (if exists)

​

Error Codes

​

Data Model

• _id: Unique photo identifier
• userId: Owner’s user ID
• userEmail: Owner’s email address
• filename: Generated filename
• uploadedAt: Upload timestamp
• size: File size in bytes
• mimeType: Image MIME type
• metadata: Additional photo metadata including:
  • requestId: The original photo request ID
  • origin: Source of the photo (e.g., “app”)
  • packageName: App that requested the photo

​

Notes

• Gallery photos are stored in MongoDB using the GalleryPhoto model
• Physical files are stored in the uploads directory
• File deletion failures are logged but don’t fail the API request
• All endpoints require glasses authentication (not regular user authentication)
• Photos are associated with users by their email address