[WIP] #252 update api docs