updated API docs with some extra params