update docs with new rest routes and broadcasted events