Update README and docs

[siddharthlatest]

Post v2.3 release (where we apply the custom headers and accept a URL that can have a prefix in its path), we should update the following docs:

• [ ] Readme (which is visible on github and npm),
• [ ] Official API reference doc over here.