Mark as Unread

OverviewCopy Anchor Link

Marks a specific notification as unread for the authenticated member. This reverts the notification's read status, removing the read timestamp and affecting the unread count and filtering.

AuthenticationCopy Anchor Link

Requires a valid Clerk JWT token in the Authorization header.

Path ParametersCopy Anchor Link

curl -X PATCH "http://localhost:3000/v1/members/me/notifications/1234/unread" \
  -H "Authorization: Bearer YOUR_CLERK_JWT"

ResponseCopy Anchor Link

Returns the updated notification object with the same structure as individual notification items from Get Notifications.

{
  "id": 1234,
  "type": "wallet",
  "title": "Points Earned",
  "message": "You earned 2,500 points from your recent stay at Luxury Resort Bali",
  "messageParts": {
    "action": "points_earned",
    "amount": 2500,
    "source": "reservation",
    "propertyName": "Luxury Resort Bali"
  },
  "isRead": false,
  "isWallet": true,
  "metadata": {
    "reservationId": "550e8400-e29b-41d4-a716-446655440000",
    "propertyId": "prop_luxury_resort_bali",
    "pointsType": "VALID"
  },
  "createdAt": "2024-04-20T10:30:00Z",
  "updatedAt": "2024-04-20T16:45:00Z",
  "readAt": null
}

BehaviorCopy Anchor Link

Read Status RevertCopy Anchor Link

• isRead: Changes from true to false
• readAt: Set to null (removed)
• updatedAt: Updated to current timestamp

Already UnreadCopy Anchor Link

• No Error: Returns 200 even if notification was already unread
• Idempotent: Safe to call multiple times
• Timestamp: updatedAt timestamp is updated to the most recent call

Ownership ValidationCopy Anchor Link

• Member Check: Only the notification owner can mark it as unread
• Security: Returns 404 if notification doesn't belong to authenticated member

Use CasesCopy Anchor Link

Undo Read ActionCopy Anchor Link

// Mark notification as unread to bring it back to user's attention
const markNotificationUnread = async (notificationId: number) => {
  try {
    const response = await fetch(`/api/members/me/notifications/${notificationId}/unread`, {
      method: 'PATCH'
    });
    
    if (response.ok) {
      // Update local state
      updateNotificationInList(notificationId, { isRead: false, readAt: null });
      // Update unread count
      incrementUnreadCount();
    }
  } catch (error) {
    console.error('Failed to mark notification as unread:', error);
  }
};

Bulk Unread OperationsCopy Anchor Link

// Mark multiple notifications as unread
const markMultipleAsUnread = async (notificationIds: number[]) => {
  const promises = notificationIds.map(id => 
    fetch(`/api/members/me/notifications/${id}/unread`, { method: 'PATCH' })
  );
  
  await Promise.allSettled(promises);
  // Refresh notification list and unread count
  refreshNotifications();
};

Admin/Support ActionsCopy Anchor Link

// Support workflow to mark important notifications as unread for user review
const flagForUserReview = async (notificationId: number) => {
  // Mark as unread to ensure user sees it again
  await markNotificationUnread(notificationId);
  
  // Optionally add metadata to track admin action
  await updateNotificationMetadata(notificationId, {
    flaggedForReview: true,
    flaggedBy: 'support',
    flaggedAt: new Date().toISOString()
  });
};

Impact on Other EndpointsCopy Anchor Link

Unread CountCopy Anchor Link

• Increased: Marking as unread increases the unread count by 1
• Immediate: Count is updated immediately
• Filtered: Affects both general and filtered counts (wallet=true)

Notification ListCopy Anchor Link

• Filtering: Notification will appear in read=false filter
• Will Not Appear: Notification will no longer appear in read=true filter
• Timestamps: Updated updatedAt and removed readAt reflect the change

Related EndpointsCopy Anchor Link

• Mark as Read - Mark notification as read
• Get Unread Count - Check updated count
• Get Notifications - View updated notification list