[PATCH v2 8/9] reservation: update api and add some helpers