Messages API

Real-time messaging system with threads, participants, and server-sent events for live updates.

Prefix: /api/messages

Endpoints

Threads

Method	Path	Description	Role
GET	/threads	List message threads for the current user	Viewer+
GET	/threads/{id}	Get thread details	Viewer+
POST	/threads	Create a new message thread	Viewer+
DELETE	/threads/{id}	Delete a thread	Viewer+

Messages

Method	Path	Description	Role
GET	/threads/{id}/messages	List messages in a thread (paginated)	Viewer+
POST	/threads/{id}/messages	Send a message to a thread	Viewer+

Participants

Method	Path	Description	Role
GET	/threads/{id}/participants	List participants in a thread	Viewer+
POST	/threads/{id}/participants	Add a participant to a thread	Viewer+
DELETE	/threads/{id}/participants/{user_id}	Remove a participant from a thread	Viewer+

Real-Time

Method	Path	Description	Role
GET	/stream	SSE stream for real-time message updates	Viewer+