[FEATURE] Have APIs document any expected exceptions

[benc-db]

Problem Statement API calls may have known, expected exceptional states that callers would want to condition on

Proposed Solution Document expected exceptions that are specific to the method in the doc string of the method, so that callers know to expect those exceptions.

Additional Context @mgyucht asked me to follow based on our call this morning.