improve API docs
add options to update_generation
fix BA API test
add error logging to MISO client
add prefetch to API views, but still slow, hmm