updating readme with latest api documentation

[skip ci]