Update the API in the README.

I *think* this is right but let me know if I've missed the mark.