Memos
Mark Memo as Read
Mark a memo as read for the authenticated user
POST
Mark a memo as read by the authenticated employee. This updates the read status for the memo recipient and tracks when the memo was acknowledged.
Authentication
Requires authentication with Bearer token. Available to:- Employee
- Manager
- HR Manager
- Super Admin
Only memo recipients can mark the memo as read. The system automatically tracks which employee marked it as read based on the authentication token.
Path Parameters
string
required
The unique identifier of the memo (UUID format)Example:
"550e8400-e29b-41d4-a716-446655440000"Response
boolean
Indicates if the request was successful
string
Confirmation message
Behavior
Key behaviors:
- Marking a memo as read is idempotent - calling it multiple times has no additional effect
- The read timestamp is recorded the first time this endpoint is called
- Read status is tracked per recipient (multiple recipients can have different read states)
- Only the recipient specified in the memo’s recipient list can mark it as read
Use Cases
This endpoint is typically used when:- An employee opens and views a memo in their inbox
- Building read receipt functionality in notification systems
- Tracking memo acknowledgment for compliance purposes
- Updating unread badge counts in the UI
Memo Read Tracking
The system tracks:Who read it
Who read it
The employee ID is captured from the authentication token
When it was read
When it was read
A timestamp is recorded when the endpoint is first called
Read percentage
Read percentage
Admins and memo creators can see what percentage of recipients have read the memo
Related Endpoints
- Get Memo - Retrieve memo details
- List Memos - View all memos (can filter by read/unread)
- Approve Memo - Approve a memo (managers)
- Reject Memo - Reject a memo (managers)