I am not sure if this need to be in specification of API as it is internal error ( unhandled value ). I think in specification we should have exceptions that we raise intentionaly, that someone use wrongly API