本文へ
ドキュメント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

更新後の未読件数。