clarified api