Add fields to Organizations Get All Members

src/Auth0.ManagementApi/Clients/IOrganizationsClient.cs

@@ -128,6 +128,16 @@ public interface IOrganizationsClient
     /// <returns>An <see cref="IPagedList{OrganizationMember}"/> containing the organization members.</returns>
     Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, PaginationInfo pagination, CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Retrieves a list of all organization members.
+    /// </summary>
+    /// <param name="organizationId">The ID of the organization for which you want to retrieve the members.</param>
+    /// <param name="request">Specifies criteria to use when querying organization members.</param>
+    /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
+    /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+    /// <returns>An <see cref="IPagedList{OrganizationMember}"/> containing the organization members.</returns>
+    Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, OrganizationGetAllMembersRequest request, PaginationInfo pagination, CancellationToken cancellationToken = default);
+
     /// <summary>
     /// Retrieves a list of all organization members using checkpoint <paramref name="pagination"/>.
     /// </summary>
@@ -137,6 +147,16 @@ public interface IOrganizationsClient
     /// <returns>An <see cref="ICheckpointPagedList{OrganizationMember}"/> containing the organization members.</returns>
     Task<ICheckpointPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, CheckpointPaginationInfo pagination, CancellationToken cancellationToken = default);
 
+    /// <summary>
+    /// Retrieves a list of all organization members using checkpoint <paramref name="pagination"/>.
+    /// </summary>
+    /// <param name="organizationId">The ID of the organization for which you want to retrieve the members.</param>
+    /// <param name="request">Specifies criteria to use when querying organization members.</param>
+    /// <param name="pagination">Specifies <see cref="CheckpointPaginationInfo"/> to use in requesting checkpoint-paginated results.</param>
+    /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+    /// <returns>An <see cref="ICheckpointPagedList{OrganizationMember}"/> containing the organization members.</returns>
+    Task<ICheckpointPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, OrganizationGetAllMembersRequest request, CheckpointPaginationInfo pagination, CancellationToken cancellationToken = default);
+
     /// <summary>
     /// Deletes members from an organization.
     /// </summary>

src/Auth0.ManagementApi/Clients/OrganizationsClient.cs

@@ -218,6 +218,19 @@ public Task AddMembersAsync(string organizationId, OrganizationAddMembersRequest
         /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
         /// <returns>An <see cref="IPagedList{OrganizationMember}"/> containing the organization members.</returns>
         public Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, PaginationInfo pagination, CancellationToken cancellationToken = default)
+        {
+            return GetAllMembersAsync(organizationId, null, pagination, cancellationToken);
+        }
+
+        /// <summary>
+        /// Retrieves a list of all organization members.
+        /// </summary>
+        /// <param name="organizationId">The ID of the organization for which you want to retrieve the members.</param>
+        /// <param name="request">Specifies criteria to use when querying organization members.</param>
+        /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
+        /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+        /// <returns>An <see cref="IPagedList{OrganizationMember}"/> containing the organization members.</returns>
+        public Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, OrganizationGetAllMembersRequest request, PaginationInfo pagination, CancellationToken cancellationToken = default)
         {
             if (pagination == null)
                 throw new ArgumentNullException(nameof(pagination));
@@ -229,6 +242,12 @@ public Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizati
                 {"include_totals", pagination.IncludeTotals.ToString().ToLower()},
             };
 
+            if (request != null)
+            {
+                queryStrings.Add("fields", request.Fields);
+                queryStrings.Add("include_fields", request.IncludeFields?.ToString().ToLower());
+            }
+
             return Connection.GetAsync<IPagedList<OrganizationMember>>(BuildUri($"organizations/{EncodePath(organizationId)}/members", queryStrings), DefaultHeaders, membersConverters, cancellationToken);
         }
 
@@ -240,6 +259,19 @@ public Task<IPagedList<OrganizationMember>> GetAllMembersAsync(string organizati
         /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
         /// <returns>An <see cref="ICheckpointPagedList{OrganizationMember}"/> containing the organization members.</returns>
         public Task<ICheckpointPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, CheckpointPaginationInfo pagination, CancellationToken cancellationToken = default)
+        {
+            return GetAllMembersAsync(organizationId, null, pagination, cancellationToken);
+        }
+
+        /// <summary>
+        /// Retrieves a list of all organization members using checkpoint <paramref name="pagination"/>.
+        /// </summary>
+        /// <param name="organizationId">The ID of the organization for which you want to retrieve the members.</param>
+        /// <param name="request">Specifies criteria to use when querying organization members.</param>
+        /// <param name="pagination">Specifies <see cref="CheckpointPaginationInfo"/> to use in requesting checkpoint-paginated results.</param>
+        /// <param name="cancellationToken">The cancellation token to cancel operation.</param>
+        /// <returns>An <see cref="ICheckpointPagedList{OrganizationMember}"/> containing the organization members.</returns>
+        public Task<ICheckpointPagedList<OrganizationMember>> GetAllMembersAsync(string organizationId, OrganizationGetAllMembersRequest request, CheckpointPaginationInfo pagination, CancellationToken cancellationToken = default)
         {
             if (pagination == null)
                 throw new ArgumentNullException(nameof(pagination));
@@ -250,6 +282,12 @@ public Task<ICheckpointPagedList<OrganizationMember>> GetAllMembersAsync(string
                 {"take", pagination.Take.ToString()},
             };
 
+            if (request != null)
+            {
+                queryStrings.Add("fields", request.Fields);
+                queryStrings.Add("include_fields", request.IncludeFields?.ToString().ToLower());
+            }
+
             return Connection.GetAsync<ICheckpointPagedList<OrganizationMember>>(BuildUri($"organizations/{EncodePath(organizationId)}/members", queryStrings), DefaultHeaders, membersCheckpointConverters, cancellationToken);
         }
 

src/Auth0.ManagementApi/Models/OrganizationGetAllMembersRequest.cs

@@ -0,0 +1,15 @@
+namespace Auth0.ManagementApi.Models
+{
+    public class OrganizationGetAllMembersRequest {
+
+        /// <summary>
+        /// A comma separated list of fields to include or exclude (depending on <see cref="IncludeFields"/>) from the result, empty to retrieve all fields.
+        /// </summary>
+        public string Fields { get; set; } = null;
+
+        /// <summary>
+        /// Specifies whether the fields specified in <see cref="Fields"/> should be included or excluded in the result.
+        /// </summary>
+        public bool? IncludeFields { get; set; } = null;
+    }
+}

tests/Auth0.ManagementApi.IntegrationTests/OrganizationTests.cs

@@ -219,9 +219,11 @@ public async Task Test_organization_members_crud_sequence()
 
             try
             {
-                var members = await RetryUtils.Retry(() => fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new Paging.PaginationInfo()), members => members.Count != 2);
+                var members = await RetryUtils.Retry(() => fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new OrganizationGetAllMembersRequest { Fields = "name", IncludeFields = false }, new Paging.PaginationInfo()), members => members.Count != 2);
 
                 members.Count.Should().Be(2);
+                members[0].Name.Should().BeNull();
+                members[1].Name.Should().BeNull();
 
                 await fixture.ApiClient.Organizations.DeleteMemberAsync(ExistingOrganizationId, new OrganizationDeleteMembersRequest
                 {
@@ -275,10 +277,12 @@ public async Task Test_organization_members_checkpoint_pagination()
 
                 await RetryUtils.Retry(() => fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new Paging.CheckpointPaginationInfo(2)), response => response.Count != 2);
 
-                var firstCheckPointPaginationRequest = await fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new Paging.CheckpointPaginationInfo(1));
+                var firstCheckPointPaginationRequest = await fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new OrganizationGetAllMembersRequest { Fields = "name", IncludeFields = false }, new Paging.CheckpointPaginationInfo(1));
                 var secondCheckPointPaginationRequest = await fixture.ApiClient.Organizations.GetAllMembersAsync(ExistingOrganizationId, new Paging.CheckpointPaginationInfo(1, firstCheckPointPaginationRequest.Paging.Next));
 
+                firstCheckPointPaginationRequest[0].Name.Should().BeNull();
                 secondCheckPointPaginationRequest.Count.Should().Be(1);
+                secondCheckPointPaginationRequest[0].Name.Should().NotBeNull();
                 secondCheckPointPaginationRequest.Paging.Next.Should().NotBeNullOrEmpty();
 
             }