User Data

​

Set DateTime

​

Endpoint

POST https://api.mentra.glass/api/user-data/set-datetime

​

Request Body

{
  "coreToken": "eyJhbGciOiJIUzI1NiIs...",
  "datetime": "2024-01-20T10:30:00Z"
}

​

Response

{
  "success": true,
  "userId": "user@example.com",
  "datetime": "2024-01-20T10:30:00Z"
}

{
  "error": "Missing or invalid coreToken or datetime (must be ISO string)"
}

{
  "error": "Invalid core token - missing user email" // or "Invalid or expired core token"
}

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

​

Implementation

• File: packages/cloud/src/routes/user-data.routes.ts:17-70
• Authentication: JWT token validation using AUGMENTOS_AUTH_JWT_SECRET
• Side Effects: Sends CUSTOM_MESSAGE to all apps subscribed to custom messages

​

Custom Message Format

{
  "type": "CUSTOM_MESSAGE",
  "action": "update_datetime",
  "payload": {
    "datetime": "2024-01-20T10:30:00Z",
    "section": "topLeft"
  },
  "timestamp": "2024-01-20T10:30:00.000Z"
}

​

Usage Notes

• The coreToken is passed in the request body rather than as a header
• This endpoint stores the datetime in the user’s session as userDatetime
• Only apps that have subscribed to the CUSTOM_MESSAGE stream type will receive the update
• The datetime is used for display purposes on the glasses

​

Error Codes