continued refinement of the REST layer