add REST documentation for activity module

Need to clarify that the actor will either be this with an array of objects containing the other properties OR just the properties specified here