we should support the preference and parent flags similar to the get API.