tweaked api.md