Page Comparison

...

Name	DBO	DTO
Message (Immutable after creation)	Primary key: Message ID Foreign key: CreatedBy (UserGroup) RecipientType (Enum ObjectType) Recipients (gzip-blob of longs) Subject (nullable) Foreign key: S3 File Handle ID CreatedOn Foreign key: replyTo (Message ID) (nullable)	ID (derived from ID generator) CreatedBy (principal ID) (upon creation filled in for the authenticated user) RecipientBundle List of recipient IDs Subject (string, optional) S3 File Handle ID CreatedOn ReplyTo inReplyTo* (optional)
Message thread	Primary key: Message ID Foreign key: Thread ID (is a Message ID) Recursive foreign key to primary key
Message Thread Object	Primary key: Thread ID Unique key: Thread ID, Object ID, Object type
Message votes	Primary key: Message ID Up votes Down votes	ID Up Down
MessageStatus	Foreign key: Message ID Foreign key: Recipient ID (UserGroup) States: UNREAD, READ, ARCHIVED	ID Recipient State
MessageSettings	Foreign key: User ID (UserGroup) Etag Blob of settings	ID Notification levels Update to an owned entity Update to some favorite entity Team Message from user Mail to everyone Etc... Message receipt email (if more than one) Auto-mark mail as read if forwarded to email
MessageBundle		Bundles the Message and Message Status
RecipientBundle		RecipientType May be a principal, entity, ... Array of IDs All IDs must be valid (404 otherwise)

...

Method	URI	Body	Parameters	Return	Description	Permission
GET	/message/inbox		Sorting + pagination	Paginated results<MessageBundle>	Gets all messages the authenticated user has received	Authenticated User
GET	/message/outbox		Sorting + pagination	Paginated results<Message>	Gets all messages the authenticated user has sent	Authenticated User
POST	/message	Message	replyTo=null (i.e. another Message)	Message	Sends a message. Note, message delivery permission is on a recipient-by-recipient basis, asynchronous to the message creation. Unauthorized delivery may result in silent failure or a bounce message (TBD).	Authenticated User Must be admin to send to AUTH_USERS
POST	/message/check	Message	replyTo=null (i.e. another Message)	Boolean ErrorResponse	Checks to see if the message is correctly formatted and that the sender has permission to send to the indicated recipients	Authenticated User
POST	/message/{id}/forward	RecipientBundle			Forwards a message to other recipients. This is equivalent to getting a (visible) message and POST-ing it to /message	Sender or Receiver
POST	/entity/{id}/comments	Message		Message	Convenience method for commenting on an entity. The service fills out fields like message ID, thread ID, and recipients, leaving just subject and body for the user.	Authenticated user with SEND_MESSAGE permission on entity
GET	/message/{id}			Message	Gets a specific message	Sender or Receiver
GET	/message/{id}/thread		Sorting + pagination	Paginated results<Message>	Gets messages belonging in the same thread as the message ID. The list is filtered according to the user's ID.	Sender or Receiver
GET	/entity/{id}/comments		Sorting + pagination	Paginated results<Message>	Gets message belonging to the thread tied to the entity.	Authenticated user with READ permission on entity
GET	/message/{id}/status			Message Status	Gets the status of a message	Receiver
PUT	/message/status	MessageStatus			Marks a message as: READ UNREAD ARCHIVED	Receiver
GET	/message/settings			MessageSettings	Gets the notification settings of the user	Authenticated User
PUT	/message/settings	MessageSettings			Changes notification settings	Authenticated User

'* 'replyTo' is a misnomer. In email 'replyTo' is the address of the person to whom you send an email reply. In this case it's the ID of the message referenced by the current message. So it should be called 'inReplyTo' or some other distinctive name.

Versions Compared

Old Version 73

New Version 74

Key