api: force users to explicitly define whether to sort files