Skip to content

Mark every unread DM from this peer as read

POST
/account/messages/{peer_ref}/read

Idempotent. Called when the caller opens the thread. Returns count of rows newly-flipped so the envelope pill can decrement deterministically.

peer_ref
required
integer format: int64

How many were just marked read.

object
marked_count
required
integer format: int64

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}