...
| Method | URI | Body | Parameters | Return | Description | Permission |
|---|---|---|---|---|---|---|
| /message/inbox | orderBy=sendDate descending=true | Paginated results<MessageBundle> | Gets all messages the authenticated user has received | Authenticated User | |
| /message/outbox | orderBy=sendDate descending=true | Paginated results<UserMessage> | Gets all messages the authenticated user has sent | Authenticated User | |
| /message | UserMessage | replyTo=null (i.e. another 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 | |
| /message/{id}/forward | RecipientBundle | Forwards a message to other recipients. This is equivalent to getting a (visible) message and POST-ing it to /message | |||
| /entity/{id}/comments | UserMessage | 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 | ||
| /message/{id} | UserMessage | Gets a specific message | Sender or Receiver | ||
| /message/{id}/thread | orderBy=sendDate descending=true | Paginated results<UserMessage> | Gets messages belonging in the same thread as the message ID. The list is filtered according to the user's ID. | Sender or Receiver | |
| /entity/{id}/comments | orderBy=sendDate descending=true | Paginated results<UserMessage> | Gets message belonging to the thread tied to the entity. | Authenticated user with READ permission on entity | |
| /message/{id}/status | Message Status | Gets the status of a message | Receiver | ||
| /message/{id}/status | Message Status | Marks a message as:
| Receiver | ||
| /message/settings | Message Settings | Gets the notification settings of the user | Authenticated User | ||
| /message/settings | Message Settings | Changes notification settings | Authenticated User |