api primitives have been setup