API updated, optional parameters annotated