"Authorization error" should not be distinguishable from "not found", i. e. we do not distinguish 403/404. However, I always thought that we handle authentication error/401 separately.

API 2.0 will definitely have machine readable errror outputs, but 1.x we'll have to leave as is for compatibility reasons.