fix bug in test causing race
allow api methods to accept models or _ids
readme updated