make the api for run a bit more consistent