update api.md, part 1