docs: migrate POST /api/sessions/{sessionId}/chats/{chatId}/read

Merged
AH
5mo ago
+100-1

Introduced a new API endpoint /api/sessions/{sessionId}/chats/{chatId}/read to allow users to mark a chat as read. Updated the OpenAPI documentation to include this new endpoint and its response schema, along with the necessary parameters and error handling. Also, added the new endpoint to the documentation index.

Summary by cubic

Adds POST /api/sessions/{sessionId}/chats/{chatId}/read to let clients mark a chat as read. After calling it, the chat’s hasUnread flag is false in subsequent list responses.

  • New Features
    • Upserts a read receipt in chat_reads (sets last_read_at = now()).
    • 200 returns MarkChatReadResponse with a boolean success=true; documents 401/403/404/500, with 404 clarified for missing session/chat or chat in a different session.
    • Docs: added “Mark Chat Read” page with description and docs index entry; combined Sessions nav.

Summary by CodeRabbit

  • New Features

    • Added a new API endpoint to mark chats as read within sessions.

  • Documentation

    • Added documentation for the mark chat read operation, including API reference details.

Review Change Stack