Add logging support and SDK regeneration — April 22, 2026 (#858)

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

Author: fern-api[bot]

EXAMPLES.md

@@ -5,6 +5,7 @@
 - [Management API usage](#management-api-usage)
 - [Verifying an ID token](#verifying-an-id-token)
 - [Organizations](#organizations)
+- [Logging](#logging)
 - [Asynchronous operations](#asynchronous-operations)
 
 ## Error handling
@@ -303,6 +304,71 @@ String url = auth.authorizeUrl("https://me.auth0.com/callback")
     .build();
 ```
 
+## Logging
+
+The SDK is silent by default. You can enable logging to see HTTP requests and responses, which is useful for debugging.
+
+### Enable logging with default settings
+
+```java
+import com.auth0.client.mgmt.ManagementApi;
+import com.auth0.client.mgmt.core.LogConfig;
+
+ManagementApi client = ManagementApi.builder()
+        .domain("{YOUR_DOMAIN}")
+        .token("{YOUR_API_TOKEN}")
+        .logging(LogConfig.builder()
+                .silent(false)
+                .build())
+        .build();
+```
+
+### Enable debug-level logging
+
+```java
+import com.auth0.client.mgmt.core.LogConfig;
+import com.auth0.client.mgmt.core.LogLevel;
+
+ManagementApi client = ManagementApi.builder()
+        .domain("{YOUR_DOMAIN}")
+        .token("{YOUR_API_TOKEN}")
+        .logging(LogConfig.builder()
+                .level(LogLevel.DEBUG)
+                .silent(false)
+                .build())
+        .build();
+```
+
+### Using a custom logger
+
+```java
+import com.auth0.client.mgmt.core.ILogger;
+import com.auth0.client.mgmt.core.LogConfig;
+import com.auth0.client.mgmt.core.LogLevel;
+
+ManagementApi client = ManagementApi.builder()
+        .domain("{YOUR_DOMAIN}")
+        .token("{YOUR_API_TOKEN}")
+        .logging(LogConfig.builder()
+                .level(LogLevel.DEBUG)
+                .logger(new MyCustomLogger()) // implements ILogger
+                .silent(false)
+                .build())
+        .build();
+```
+
+Logging is also available on the async client:
+
+```java
+AsyncManagementApi asyncClient = AsyncManagementApi.builder()
+        .token("{YOUR_API_TOKEN}")
+        .tenantDomain("{YOUR_DOMAIN}")
+        .logging(LogConfig.builder()
+                .silent(false)
+                .build())
+        .build();
+```
+
 ## Asynchronous operations
 
 ### Management API

reference.md

@@ -12569,7 +12569,7 @@ client.userAttributeProfiles().list(
 <dl>
 <dd>
 
-Retrieve details about a single User Attribute Profile specified by ID. 
+Create a User Attribute Profile
 </dd>
 </dl>
 </dd>
@@ -17514,9 +17514,12 @@ client.branding().phone().templates().update(
 <dd>
 
 ```java
-client.branding().phone().templates().reset("id", new 
-HashMap<String, Object>() {{put("key", "value");
-}});
+client.branding().phone().templates().reset(
+    "id",
+    ResetPhoneTemplateRequestContent.of(new 
+    HashMap<String, Object>() {{put("key", "value");
+    }})
+);
 ```
 </dd>
 </dl>
@@ -31029,7 +31032,7 @@ client.users().sessions().delete("user_id");
 <dl>
 <dd>
 
-List a verifiable credential templates.
+List verifiable credential templates.
 </dd>
 </dl>
 </dd>
@@ -31420,3 +31423,4 @@ client.verifiableCredentials().verification().templates().update(
 </dd>
 </dl>
 </details>
+

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

@@ -5,6 +5,7 @@
 
 import com.auth0.client.mgmt.core.ClientOptions;
 import com.auth0.client.mgmt.core.Environment;
+import com.auth0.client.mgmt.core.LogConfig;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Optional;
@@ -23,6 +24,8 @@ public class AsyncManagementApiBuilder {
 
     private OkHttpClient httpClient;
 
+    private Optional<LogConfig> logging = Optional.empty();
+
     private String tenantDomain;
 
     /**
@@ -67,6 +70,14 @@ public AsyncManagementApiBuilder httpClient(OkHttpClient httpClient) {
         return this;
     }
 
+    /**
+     * Configure logging for the SDK. Silent by default — no log output unless explicitly configured.
+     */
+    public AsyncManagementApiBuilder logging(LogConfig logging) {
+        this.logging = Optional.of(logging);
+        return this;
+    }
+
     /**
      * Add a custom header to be sent with all requests.
      * For headers that need to be computed dynamically or conditionally, use the setAdditional() method override instead.
@@ -92,6 +103,7 @@ protected ClientOptions buildClientOptions() {
         setHttpClient(builder);
         setTimeouts(builder);
         setRetries(builder);
+        setLogging(builder);
         for (Map.Entry<String, String> header : this.customHeaders.entrySet()) {
             builder.addHeader(header.getKey(), header.getValue());
         }
@@ -171,6 +183,18 @@ protected void setHttpClient(ClientOptions.Builder builder) {
         }
     }
 
+    /**
+     * Sets the logging configuration for the SDK.
+     * Override this method to customize logging behavior.
+     *
+     * @param builder The ClientOptions.Builder to configure
+     */
+    protected void setLogging(ClientOptions.Builder builder) {
+        if (this.logging.isPresent()) {
+            builder.logging(this.logging.get());
+        }
+    }
+
     /**
      * Override this method to add any additional configuration to the client.
      * This method is called at the end of the configuration chain, allowing you to add

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

@@ -222,6 +222,11 @@ public void onResponse(@NotNull Call call, @NotNull Response response) throws IO
                     }
                     try {
                         switch (response.code()) {
+                            case 400:
+                                future.completeExceptionally(new BadRequestError(
+                                        ObjectMappers.JSON_MAPPER.readValue(responseBodyString, Object.class),
+                                        response));
+                                return;
                             case 401:
                                 future.completeExceptionally(new UnauthorizedError(
                                         ObjectMappers.JSON_MAPPER.readValue(responseBodyString, Object.class),

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

@@ -181,15 +181,15 @@ public void onFailure(@NotNull Call call, @NotNull IOException e) {
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CompletableFuture<ManagementApiHttpResponse<CreateUserAttributeProfileResponseContent>> create(
             CreateUserAttributeProfileRequestContent request) {
         return create(request, null);
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CompletableFuture<ManagementApiHttpResponse<CreateUserAttributeProfileResponseContent>> create(
             CreateUserAttributeProfileRequestContent request, RequestOptions requestOptions) {

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

@@ -65,15 +65,15 @@ public CompletableFuture<SyncPagingIterable<UserAttributeProfile>> list(
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CompletableFuture<CreateUserAttributeProfileResponseContent> create(
             CreateUserAttributeProfileRequestContent request) {
         return this.rawClient.create(request).thenApply(response -> response.body());
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CompletableFuture<CreateUserAttributeProfileResponseContent> create(
             CreateUserAttributeProfileRequestContent request, RequestOptions requestOptions) {

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

@@ -3,10 +3,7 @@
  */
 package com.auth0.client.mgmt;
 
-import com.auth0.client.mgmt.core.ClientOptions;
-import com.auth0.client.mgmt.core.CustomDomainInterceptor;
-import com.auth0.client.mgmt.core.Environment;
-import com.auth0.client.mgmt.core.OAuthTokenSupplier;
+import com.auth0.client.mgmt.core.*;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Optional;
@@ -26,6 +23,8 @@ public class ManagementApiBuilder {
 
     private OkHttpClient httpClient;
 
+    private Optional<LogConfig> logging = Optional.empty();
+
     private String customDomain = null;
 
     // Domain-based initialization fields
@@ -168,6 +167,14 @@ public ManagementApiBuilder httpClient(OkHttpClient httpClient) {
         return this;
     }
 
+    /**
+     * Configure logging for the SDK. Silent by default — no log output unless explicitly configured.
+     */
+    public ManagementApiBuilder logging(LogConfig logging) {
+        this.logging = Optional.of(logging);
+        return this;
+    }
+
     /**
      * Add a custom header to be sent with all requests.
      * For headers that need to be computed dynamically or conditionally, use the setAdditional() method override instead.
@@ -188,6 +195,7 @@ protected ClientOptions buildClientOptions() {
         setHttpClient(builder);
         setTimeouts(builder);
         setRetries(builder);
+        setLogging(builder);
         for (Map.Entry<String, String> header : this.customHeaders.entrySet()) {
             builder.addHeader(header.getKey(), header.getValue());
         }
@@ -293,6 +301,18 @@ protected void setHttpClient(ClientOptions.Builder builder) {
         }
     }
 
+    /**
+     * Sets the logging configuration for the SDK.
+     * Override this method to customize logging behavior.
+     *
+     * @param builder The ClientOptions.Builder to configure
+     */
+    protected void setLogging(ClientOptions.Builder builder) {
+        if (this.logging.isPresent()) {
+            builder.logging(this.logging.get());
+        }
+    }
+
     /**
      * Override this method to add any additional configuration to the client.
      * This method is called at the end of the configuration chain, allowing you to add

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

@@ -181,6 +181,9 @@ public ManagementApiHttpResponse<GetRefreshTokenResponseContent> get(String id,
             }
             try {
                 switch (response.code()) {
+                    case 400:
+                        throw new BadRequestError(
+                                ObjectMappers.JSON_MAPPER.readValue(responseBodyString, Object.class), response);
                     case 401:
                         throw new UnauthorizedError(
                                 ObjectMappers.JSON_MAPPER.readValue(responseBodyString, Object.class), response);

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

@@ -146,15 +146,15 @@ public ManagementApiHttpResponse<SyncPagingIterable<UserAttributeProfile>> list(
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public ManagementApiHttpResponse<CreateUserAttributeProfileResponseContent> create(
             CreateUserAttributeProfileRequestContent request) {
         return create(request, null);
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public ManagementApiHttpResponse<CreateUserAttributeProfileResponseContent> create(
             CreateUserAttributeProfileRequestContent request, RequestOptions requestOptions) {

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

@@ -63,14 +63,14 @@ public SyncPagingIterable<UserAttributeProfile> list(
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CreateUserAttributeProfileResponseContent create(CreateUserAttributeProfileRequestContent request) {
         return this.rawClient.create(request).body();
     }
 
     /**
-     * Retrieve details about a single User Attribute Profile specified by ID.
+     * Create a User Attribute Profile
      */
     public CreateUserAttributeProfileResponseContent create(
             CreateUserAttributeProfileRequestContent request, RequestOptions requestOptions) {