improve api: add modifications features