List users matching the specified criteria. Provide userIDs to look up specific users, or tenantID to list all users with access to an organization. If both are provided, tenantID takes precedence.

When includeSettings is true, each user object includes the nested tenantSettings containing notification preferences, dashboard preferences, recommendation filters, and display settings for the specified tenant.

Alternatively, provide reportOwnerCandidatesInTenantID or dashboardOwnerCandidatesInTenantID (checked before userIDs/tenantID) to list the members eligible to become a report's or dashboard's owner in that tenant. This mode requires the corresponding TRANSFER_*_OWNERSHIP permission and returns the minimal { candidates } projection instead of { users }.