跳至文檔內容
開發者文檔API 參考將訊息標為已讀
POSTBearer 權杖

將訊息標為已讀

/api/v1/messages

將清單回應所附時間戳記之前及該時間的訊息標為已讀。

API 欄位名稱、型別與程式碼在所有語言中保持原樣。

請求範例

cURL
curl "https://tovahub.com/api/v1/messages" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "through": "2026-11-07T12:00:00.000Z"
}'

僅提供範例,此頁不會發送 API 請求。

參數

throughJSON 請求主體 · 必填

string · ISO datetime

請使用 list_messages 回傳的 through 時間戳記,以保留較新訊息的未讀狀態。

回應

HTTP 狀態 200

將組織中建立時間不晚於指定截止時間的訊息標為已讀。

okboolean (true)

更新已完成。

userIdstring (ObjectId)

已驗證的使用者識別碼。

throughstring (ISO 8601)

傳入的截止時間戳記。

readAtstring (ISO 8601)

此已讀操作記錄的時間戳記。

unreadCountnumber

更新後的未讀數量。