add REST documentation for activity module

I haven't seen anything in swagger that allows for type flexibility like that.