add REST documentation for activity module

I don't think there's a way to do that in Swagger. You can define enumerated values for, e.g. a string property, but I don't see how to define a property that can be one of several different types. Maybe @stuartf has an idea?