i missed way too much. 2 coffees aren't enough today
sync up with what we have in test data right now.
return better error codes for some cases.