update docs
simplify handling api errors