this is a good bare-bones api, but do we want a comfort api  on top of this too?