updated api docs
updated example