added api documentation for oauth2-lib

done for [AGIOS-273](https://issues.jboss.org/browse/AGIOS-273)
/Returns a bolean/Return a boolean/s