I see this is properly documented in the interface. https://github.com/owncloud/core/pull/7075/files#diff-8334ac3e7a5cfde599fc1fb11c855e6eR319