clarified error assertions for various APIs