minor changes to api.md