Messages

Internal messaging system for team communication.

Get All Messages

GET/api/messages

Get all messages for the current user.

{ "messages": [ { "id": "...", "sender": { "id": "...", "name": "John", "avatarUrl": "..." }, "recipient": { "id": "...", "name": "Jane" }, "message": "Hello!", "receivedAt": "2024-01-15T10:30:00Z", "readAt": null } ] }

Send Message

POST/api/messages

Send a message to another user.

FieldTypeRequiredDescription
recipientstringRequiredRecipient user ID
messagestringRequiredMessage content
{ "message": { "id": "...", "message": "Hello!", "receivedAt": "2024-01-15T10:30:00Z" } }

Get Conversation

GET/api/messages/conversation

Get conversation with a specific user.

Query ParamTypeRequiredDescription
userIdstringRequiredUser ID to get conversation with
{ "messages": [...] }

Get Unread Count

GET/api/messages/unread-count

Get count of unread messages.

{ "count": 5 }