fix api documentation
adapt available_watchers api to changed interface, introduce authorization
fix watcher selection

* path was wrong
* elements are now embedded. Adaptation in frontend required for that
* link to availableWatchers was always presented. Changing that need handling in frontend
Merge pull request #2310 from opf/fix/available_watchers