Mark a conversation unread from one message onward
POST/api/conversations/:conversationId/messages/:messageId/unread
The per-message inverse of markConversationRead. Rewinds the ACTING
agent's read cursor to just before the given message: everything earlier
stays read, this message and everything after it count as unread again.
Per-agent — a teammate's badge is untouched.
Use it when an agent reads down a thread and wants one message to come
back. To make the whole thread unread, use the bulk endpoint's unread
action instead.
Returns the conversation's unread count for this agent afterwards, so a client can settle its optimistic badge without a second request.
Request
Responses
- 200
- 401
- 403
- 404
The cursor was rewound.
Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).
Authenticated but not allowed.
Resource not found (or not visible to the current tenant).