scheduler: iterate on the API