New API docs.

This is to be accepted only when the final version of the api is released.