read response, updated api docs