Update api.md

Add warning that this discusses a future API. Close #35