REF: make api more aligned with the goal of simply parsing request &
passing to underlyingmodel