add more examples, make debugging output better when api command fails