Add Default Domain Management and CIMD Support - April 8, 2026 (auth0#851)

Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>
Co-authored-by: Tanya Sinha <sinha.tanya26@gmail.com>

Author: fern-api[bot]

reference.md

@@ -15,6 +15,10 @@
 import com.auth0.client.mgmt.types.GetClientRequestParameters;
 import com.auth0.client.mgmt.types.GetClientResponseContent;
 import com.auth0.client.mgmt.types.ListClientsRequestParameters;
+import com.auth0.client.mgmt.types.PreviewCimdMetadataRequestContent;
+import com.auth0.client.mgmt.types.PreviewCimdMetadataResponseContent;
+import com.auth0.client.mgmt.types.RegisterCimdClientRequestContent;
+import com.auth0.client.mgmt.types.RegisterCimdClientResponseContent;
 import com.auth0.client.mgmt.types.RotateClientSecretResponseContent;
 import com.auth0.client.mgmt.types.UpdateClientRequestContent;
 import com.auth0.client.mgmt.types.UpdateClientResponseContent;
@@ -238,6 +242,46 @@ public CompletableFuture<CreateClientResponseContent> create(
         return this.rawClient.create(request, requestOptions).thenApply(response -> response.body());
     }
 
+    /**
+     * Fetches and validates a Client ID Metadata Document without creating a client.
+     * Returns the raw metadata and how it would be mapped to Auth0 client fields.
+     * This endpoint is useful for testing metadata URIs before creating CIMD clients.
+     */
+    public CompletableFuture<PreviewCimdMetadataResponseContent> previewCimdMetadata(
+            PreviewCimdMetadataRequestContent request) {
+        return this.rawClient.previewCimdMetadata(request).thenApply(response -> response.body());
+    }
+
+    /**
+     * Fetches and validates a Client ID Metadata Document without creating a client.
+     * Returns the raw metadata and how it would be mapped to Auth0 client fields.
+     * This endpoint is useful for testing metadata URIs before creating CIMD clients.
+     */
+    public CompletableFuture<PreviewCimdMetadataResponseContent> previewCimdMetadata(
+            PreviewCimdMetadataRequestContent request, RequestOptions requestOptions) {
+        return this.rawClient.previewCimdMetadata(request, requestOptions).thenApply(response -> response.body());
+    }
+
+    /**
+     * Idempotent registration for Client ID Metadata Document (CIMD) clients.
+     * Uses external_client_id as the unique identifier for upsert operations.
+     * <strong>Create:</strong> Returns 201 when a new client is created (requires \
+     */
+    public CompletableFuture<RegisterCimdClientResponseContent> registerCimdClient(
+            RegisterCimdClientRequestContent request) {
+        return this.rawClient.registerCimdClient(request).thenApply(response -> response.body());
+    }
+
+    /**
+     * Idempotent registration for Client ID Metadata Document (CIMD) clients.
+     * Uses external_client_id as the unique identifier for upsert operations.
+     * <strong>Create:</strong> Returns 201 when a new client is created (requires \
+     */
+    public CompletableFuture<RegisterCimdClientResponseContent> registerCimdClient(
+            RegisterCimdClientRequestContent request, RequestOptions requestOptions) {
+        return this.rawClient.registerCimdClient(request, requestOptions).thenApply(response -> response.body());
+    }
+
     /**
      * Retrieve client details by ID. Clients are SSO connections or Applications linked with your Auth0 tenant. A list of fields to include or exclude may also be specified.
      * For more information, read <a href="https://www.auth0.com/docs/get-started/applications"> Applications in Auth0</a> and <a href="https://www.auth0.com/docs/authenticate/single-sign-on"> Single Sign-On</a>.

src/main/java/com/auth0/client/mgmt/AsyncClientsClient.java

@@ -9,10 +9,13 @@
 import com.auth0.client.mgmt.types.CreateCustomDomainResponseContent;
 import com.auth0.client.mgmt.types.CustomDomain;
 import com.auth0.client.mgmt.types.GetCustomDomainResponseContent;
+import com.auth0.client.mgmt.types.GetDefaultDomainResponseContent;
 import com.auth0.client.mgmt.types.ListCustomDomainsRequestParameters;
+import com.auth0.client.mgmt.types.SetDefaultCustomDomainRequestContent;
 import com.auth0.client.mgmt.types.TestCustomDomainResponseContent;
 import com.auth0.client.mgmt.types.UpdateCustomDomainRequestContent;
 import com.auth0.client.mgmt.types.UpdateCustomDomainResponseContent;
+import com.auth0.client.mgmt.types.UpdateDefaultDomainResponseContent;
 import com.auth0.client.mgmt.types.VerifyCustomDomainResponseContent;
 import java.util.List;
 import java.util.concurrent.CompletableFuture;
@@ -100,6 +103,36 @@ public CompletableFuture<CreateCustomDomainResponseContent> create(
         return this.rawClient.create(request, requestOptions).thenApply(response -> response.body());
     }
 
+    /**
+     * Retrieve the tenant's default domain.
+     */
+    public CompletableFuture<GetDefaultDomainResponseContent> getDefault() {
+        return this.rawClient.getDefault().thenApply(response -> response.body());
+    }
+
+    /**
+     * Retrieve the tenant's default domain.
+     */
+    public CompletableFuture<GetDefaultDomainResponseContent> getDefault(RequestOptions requestOptions) {
+        return this.rawClient.getDefault(requestOptions).thenApply(response -> response.body());
+    }
+
+    /**
+     * Set the default custom domain for the tenant.
+     */
+    public CompletableFuture<UpdateDefaultDomainResponseContent> setDefault(
+            SetDefaultCustomDomainRequestContent request) {
+        return this.rawClient.setDefault(request).thenApply(response -> response.body());
+    }
+
+    /**
+     * Set the default custom domain for the tenant.
+     */
+    public CompletableFuture<UpdateDefaultDomainResponseContent> setDefault(
+            SetDefaultCustomDomainRequestContent request, RequestOptions requestOptions) {
+        return this.rawClient.setDefault(request, requestOptions).thenApply(response -> response.body());
+    }
+
     /**
      * Retrieve a custom domain configuration and status.
      */

src/main/java/com/auth0/client/mgmt/AsyncCustomDomainsClient.java

@@ -77,6 +77,20 @@ public CompletableFuture<GetGroupResponseContent> get(String id, RequestOptions
         return this.rawClient.get(id, requestOptions).thenApply(response -> response.body());
     }
 
+    /**
+     * Delete a group by its ID.
+     */
+    public CompletableFuture<Void> delete(String id) {
+        return this.rawClient.delete(id).thenApply(response -> response.body());
+    }
+
+    /**
+     * Delete a group by its ID.
+     */
+    public CompletableFuture<Void> delete(String id, RequestOptions requestOptions) {
+        return this.rawClient.delete(id, requestOptions).thenApply(response -> response.body());
+    }
+
     public AsyncMembersClient members() {
         return this.membersClient.get();
     }