ovahub
Skip to documentation
DocumentationAPI referenceMark messages read
POSTBearer token

Mark messages read

/api/v1/messages

Mark messages through the timestamp returned by the list response.

Request example

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"
}'

Examples only. No requests are sent from this page.

Parameters

throughJSON body · Required

string · ISO datetime

Use the through timestamp from list_messages to keep newer messages unread.

Response

HTTP status 200

Mark organization messages created through the supplied cutoff as read.

okboolean (true)

The update completed.

userIdstring (ObjectId)

Authenticated user identifier.

throughstring (ISO 8601)

The supplied cutoff timestamp.

readAtstring (ISO 8601)

Timestamp recorded for the read operation.

unreadCountnumber

Unread count after the update.

Related

Requests & errorsAuthentication