finished specifying api for scenarios