revert api change, update documentation