An API for the warren service