I just filed a patch that addresses this issue and proposes the @inbox and @outbox reserved values, besides the generic object-id placeholder..
however there are still some inconsistencies in the Message object definition, in particular:
- use of "senderId" versus "sender { id: }" model for inserting the id of the sender. the table defining the properties and the example are not aligned but before submitting any patch i'd like to sense the feeling of the group on the best approach
- reserved values for "status". so far the "new", "read", and "deleted" values are cited but no semantics is associated to them. at some point an "unread" status is mentioned in an example. i also do not really understand in which case a "deleted" status would appear. suggestions for clarifying this?
- reserved values for "type" are not defined. examples in the spec show "privateMessage" and "EMAIL" but these are not formally defined, should they?
thanks
walter