Merge pull request #8 from docusign/sdk-update-java-1.0.0-beta.9

Update java SDK

Author: prudhvik-docusign

.gitattributes

@@ -4,8 +4,5 @@
 # Linux start script should use lf
 /gradlew        text eol=lf
 
-# These are Windows script files and should use crlf
-*.bat           text eol=crlf
-
 # This allows generated code to be indexed correctly
 *.java linguist-generated=false

README.md

@@ -38,6 +38,7 @@ Developer Center](https://developers.docusign.com/).
   * [Server Selection](#server-selection)
   * [Custom HTTP Client](#custom-http-client)
   * [Debugging](#debugging)
+  * [Jackson Configuration](#jackson-configuration)
 * [Development](#development)
   * [Maturity](#maturity)
   * [Contributions](#contributions)
@@ -55,15 +56,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.docusign:iam-sdk:1.0.0-beta.8'
+implementation 'com.docusign:iam-sdk:1.0.0-beta.9'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.docusign</groupId>
     <artifactId>iam-sdk</artifactId>
-    <version>1.0.0-beta.8</version>
+    <version>1.0.0-beta.9</version>
 </dependency>
 ```
 
@@ -107,11 +108,20 @@ public class Application {
                 .call();
 
         if (res.userInfo().isPresent()) {
-            // handle response
+            System.out.println(res.userInfo().get());
         }
     }
 }
 ```
+
+#### Union Consumption Patterns
+
+When a response field is a union model:
+
+- Discriminated unions: branch on the discriminator (`switch`) and then narrow to the concrete type.
+- Non-discriminated unions: use generated accessors (for example `string()`, `asLong()`, `simpleObject()`) to determine the active variant.
+
+For full model-specific examples (including Java 11/16/21 variants), see each union model's **Supported Types** section in the generated model docs.
 <!-- End SDK Example Usage [usage] -->
 
 <!-- Start Authentication [security] -->
@@ -280,6 +290,22 @@ var res = sdk.auth().getUserInfo().call();
 <details open>
 <summary>Available methods</summary>
 
+### [AgreementManager.Agreements](docs/sdks/agreements/README.md)
+
+* [getAgreementsList](docs/sdks/agreements/README.md#getagreementslist) - Retrieve a list of agreements
+* [patchAgreementByDocumentId](docs/sdks/agreements/README.md#patchagreementbydocumentid) - Update an agreement by locating it via document ID
+* [getAgreementTypes](docs/sdks/agreements/README.md#getagreementtypes) - List configured agreement types for the account.
+* [getAgreement](docs/sdks/agreements/README.md#getagreement) - Retrieve detailed information about a specific agreement
+* [deleteAgreement](docs/sdks/agreements/README.md#deleteagreement) - Delete a specific agreement
+* [patchAgreement](docs/sdks/agreements/README.md#patchagreement) - Update specific fields of an agreement
+* [changeAgreementType](docs/sdks/agreements/README.md#changeagreementtype) - Change the type of an agreement
+
+### [AgreementManager.BulkJob](docs/sdks/bulkjob/README.md)
+
+* [createBulkUploadJob](docs/sdks/bulkjob/README.md#createbulkuploadjob) - Create new bulk job with presigned URLs direct to Azure Blob Store
+* [getBulkJobStatus](docs/sdks/bulkjob/README.md#getbulkjobstatus) - Get bulk job status
+* [uploadCompleteBulkJob](docs/sdks/bulkjob/README.md#uploadcompletebulkjob) - Mark bulk job upload as complete
+
 ### [Auth](docs/sdks/auth/README.md)
 
 * [getTokenFromConfidentialAuthCode](docs/sdks/auth/README.md#gettokenfromconfidentialauthcode) - Obtains an access token from the Docusign API using an authorization code.
@@ -292,32 +318,20 @@ var res = sdk.auth().getUserInfo().call();
 
 * [getConnectedFieldsTabGroups](docs/sdks/tabinfo/README.md#getconnectedfieldstabgroups) - Returns all tabs associated with the given account
 
-### [Maestro.WorkflowInstanceManagement](docs/sdks/workflowinstancemanagement/README.md)
+### [WorkflowBuilder.WorkflowInstanceManagement](docs/sdks/workflowinstancemanagement/README.md)
 
 * [getWorkflowInstancesList](docs/sdks/workflowinstancemanagement/README.md#getworkflowinstanceslist) - Retrieve All Workflow Instances
 * [getWorkflowInstance](docs/sdks/workflowinstancemanagement/README.md#getworkflowinstance) - Retrieve a Workflow Instance
 * [cancelWorkflowInstance](docs/sdks/workflowinstancemanagement/README.md#cancelworkflowinstance) - Cancel a Running Workflow Instance
 
-### [Maestro.Workflows](docs/sdks/workflows/README.md)
+### [WorkflowBuilder.Workflows](docs/sdks/workflows/README.md)
 
-* [getWorkflowsList](docs/sdks/workflows/README.md#getworkflowslist) - Retrieve a list of available Maestro workflows
-* [getWorkflowTriggerRequirements](docs/sdks/workflows/README.md#getworkflowtriggerrequirements) - Retrieve trigger requirements for a specific Maestro workflow
-* [triggerWorkflow](docs/sdks/workflows/README.md#triggerworkflow) - Trigger a new instance of a Maestro workflow
+* [getWorkflowsList](docs/sdks/workflows/README.md#getworkflowslist) - Retrieve a list of available Workflow Builder workflows
+* [getWorkflowTriggerRequirements](docs/sdks/workflows/README.md#getworkflowtriggerrequirements) - Retrieve trigger requirements for a specific Workflow Builder workflow
+* [triggerWorkflow](docs/sdks/workflows/README.md#triggerworkflow) - Trigger a new instance of a Workflow Builder workflow
 * [pauseNewWorkflowInstances](docs/sdks/workflows/README.md#pausenewworkflowinstances) - Pause an Active Workflow
 * [resumePausedWorkflow](docs/sdks/workflows/README.md#resumepausedworkflow) - Resume a Paused Workflow
 
-### [Navigator.Agreements](docs/sdks/agreements/README.md)
-
-* [getAgreementsList](docs/sdks/agreements/README.md#getagreementslist) - Retrieve a list of agreements
-* [getAgreement](docs/sdks/agreements/README.md#getagreement) - Retrieve detailed information about a specific agreement
-* [deleteAgreement](docs/sdks/agreements/README.md#deleteagreement) - Delete a specific agreement
-
-### [Navigator.BulkJob](docs/sdks/bulkjob/README.md)
-
-* [createBulkUploadJob](docs/sdks/bulkjob/README.md#createbulkuploadjob) - Create new bulk job with presigned URLs direct to Azure Blob Store
-* [getBulkJobStatus](docs/sdks/bulkjob/README.md#getbulkjobstatus) - Get bulk job status
-* [uploadCompleteBulkJob](docs/sdks/bulkjob/README.md#uploadcompletebulkjob) - Mark bulk job upload as complete
-
 ### [Workspaces.WorkspaceBrands](docs/sdks/workspacebrands/README.md)
 
 * [getWorkspaceBrand](docs/sdks/workspacebrands/README.md#getworkspacebrand) - Returns details about the brand set for a workspace
@@ -411,7 +425,7 @@ public class Application {
                 .call();
 
         if (res.authorizationCodeGrantResponse().isPresent()) {
-            // handle response
+            System.out.println(res.authorizationCodeGrantResponse().get());
         }
     }
 }
@@ -461,7 +475,7 @@ public class Application {
                 .call();
 
         if (res.authorizationCodeGrantResponse().isPresent()) {
-            // handle response
+            System.out.println(res.authorizationCodeGrantResponse().get());
         }
     }
 }
@@ -522,7 +536,7 @@ public class Application {
                     .call();
 
             if (res.authorizationCodeGrantResponse().isPresent()) {
-                // handle response
+                System.out.println(res.authorizationCodeGrantResponse().get());
             }
         } catch (IamClientError ex) { // all SDK exceptions inherit from IamClientError
 
@@ -564,7 +578,7 @@ public class Application {
 **Primary error:**
 * [`IamClientError`](./src/main/java/models/errors/IamClientError.java): The base class for HTTP error responses.
 
-<details><summary>Less common errors (10)</summary>
+<details><summary>Less common errors (9)</summary>
 
 <br />
 
@@ -574,10 +588,9 @@ public class Application {
 many more subclasses in the JDK platform).
 
 **Inherit from [`IamClientError`](./src/main/java/models/errors/IamClientError.java)**:
-* [`com.docusign.iam.sdk.models.errors.ErrorDetails`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.ErrorDetails.java): The error response object for the Workspaces API. Applicable to 26 of 46 methods.*
-* [`com.docusign.iam.sdk.models.errors.Error`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.Error.java): Bad Request - The request could not be understood or was missing required parameters. Applicable to 10 of 46 methods.*
-* [`com.docusign.iam.sdk.models.errors.OAuthErrorResponse`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.OAuthErrorResponse.java): Status code `400`. Applicable to 5 of 46 methods.*
-* [`com.docusign.iam.sdk.models.errors.ErrDetails`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.ErrDetails.java): Applicable to 3 of 46 methods.*
+* [`com.docusign.iam.sdk.models.errors.ErrorDetails`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.ErrorDetails.java): The error response object for the Workspaces API. Applicable to 26 of 50 methods.*
+* [`com.docusign.iam.sdk.models.errors.ErrDetails`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.ErrDetails.java): Error response conforming to RFC 9457 (Problem Details for HTTP APIs). See: https://www.rfc-editor.org/rfc/rfc9457.html. Applicable to 17 of 50 methods.*
+* [`com.docusign.iam.sdk.models.errors.OAuthErrorResponse`](./src/main/java/models/errors/com.docusign.iam.sdk.models.errors.OAuthErrorResponse.java): Status code `400`. Applicable to 5 of 50 methods.*
 
 
 </details>
@@ -603,34 +616,27 @@ You can override the default server globally using the `.server(AvailableServers
 package hello.world;
 
 import com.docusign.iam.sdk.IamClient;
-import com.docusign.iam.sdk.models.components.ConfidentialAuthCodeGrantRequestBody;
-import com.docusign.iam.sdk.models.errors.OAuthErrorResponse;
-import com.docusign.iam.sdk.models.operations.GetTokenFromConfidentialAuthCodeResponse;
-import com.docusign.iam.sdk.models.operations.GetTokenFromConfidentialAuthCodeSecurity;
+import com.docusign.iam.sdk.models.errors.ErrDetails;
+import com.docusign.iam.sdk.models.operations.GetWorkflowsListResponse;
+import com.docusign.iam.sdk.models.operations.Status;
 import java.lang.Exception;
 
 public class Application {
 
-    public static void main(String[] args) throws OAuthErrorResponse, Exception {
+    public static void main(String[] args) throws ErrDetails, Exception {
 
         IamClient sdk = IamClient.builder()
                 .server(IamClient.AvailableServers.DEMO)
+                .accessToken(System.getenv().getOrDefault("ACCESS_TOKEN", ""))
             .build();
 
-        ConfidentialAuthCodeGrantRequestBody req = ConfidentialAuthCodeGrantRequestBody.builder()
-                .code("eyJ0eXAi.....QFsje43QVZ_gw")
-                .build();
-
-        GetTokenFromConfidentialAuthCodeResponse res = sdk.auth().getTokenFromConfidentialAuthCode()
-                .request(req)
-                .security(GetTokenFromConfidentialAuthCodeSecurity.builder()
-                    .clientId("2da1cb14-xxxx-xxxx-xxxx-5b7b40829e79")
-                    .secretKey("MTIzNDU2Nzxxxxxxxxxxxxxxxxxxxxx0NTY3ODkwMTI")
-                    .build())
+        GetWorkflowsListResponse res = sdk.workflowBuilder().workflows().getWorkflowsList()
+                .accountId("ae232f1f-8efc-4b8c-bb08-626847fad8bb")
+                .status(Status.ACTIVE)
                 .call();
 
-        if (res.authorizationCodeGrantResponse().isPresent()) {
-            // handle response
+        if (res.workflowsListSuccess().isPresent()) {
+            System.out.println(res.workflowsListSuccess().get());
         }
     }
 }
@@ -643,34 +649,27 @@ The default server can also be overridden globally using the `.serverURL(String
 package hello.world;
 
 import com.docusign.iam.sdk.IamClient;
-import com.docusign.iam.sdk.models.components.ConfidentialAuthCodeGrantRequestBody;
-import com.docusign.iam.sdk.models.errors.OAuthErrorResponse;
-import com.docusign.iam.sdk.models.operations.GetTokenFromConfidentialAuthCodeResponse;
-import com.docusign.iam.sdk.models.operations.GetTokenFromConfidentialAuthCodeSecurity;
+import com.docusign.iam.sdk.models.errors.ErrDetails;
+import com.docusign.iam.sdk.models.operations.GetWorkflowsListResponse;
+import com.docusign.iam.sdk.models.operations.Status;
 import java.lang.Exception;
 
 public class Application {
 
-    public static void main(String[] args) throws OAuthErrorResponse, Exception {
+    public static void main(String[] args) throws ErrDetails, Exception {
 
         IamClient sdk = IamClient.builder()
                 .serverURL("https://api-d.docusign.com")
+                .accessToken(System.getenv().getOrDefault("ACCESS_TOKEN", ""))
             .build();
 
-        ConfidentialAuthCodeGrantRequestBody req = ConfidentialAuthCodeGrantRequestBody.builder()
-                .code("eyJ0eXAi.....QFsje43QVZ_gw")
-                .build();
-
-        GetTokenFromConfidentialAuthCodeResponse res = sdk.auth().getTokenFromConfidentialAuthCode()
-                .request(req)
-                .security(GetTokenFromConfidentialAuthCodeSecurity.builder()
-                    .clientId("2da1cb14-xxxx-xxxx-xxxx-5b7b40829e79")
-                    .secretKey("MTIzNDU2Nzxxxxxxxxxxxxxxxxxxxxx0NTY3ODkwMTI")
-                    .build())
+        GetWorkflowsListResponse res = sdk.workflowBuilder().workflows().getWorkflowsList()
+                .accountId("ae232f1f-8efc-4b8c-bb08-626847fad8bb")
+                .status(Status.ACTIVE)
                 .call();
 
-        if (res.authorizationCodeGrantResponse().isPresent()) {
-            // handle response
+        if (res.workflowsListSuccess().isPresent()) {
+            System.out.println(res.workflowsListSuccess().get());
         }
     }
 }
@@ -710,7 +709,7 @@ public class Application {
                 .call();
 
         if (res.authorizationCodeGrantResponse().isPresent()) {
-            // handle response
+            System.out.println(res.authorizationCodeGrantResponse().get());
         }
     }
 }
@@ -876,6 +875,36 @@ __NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging
 Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
 <!-- End Debugging [debug] -->
 
+<!-- Start Jackson Configuration [jackson] -->
+## Jackson Configuration
+
+The SDK ships with a pre-configured Jackson [`ObjectMapper`][jackson-databind] accessible via
+`JSON.getMapper()`. It is set up with type modules, strict deserializers, and the feature flags
+needed for full SDK compatibility (including ISO-8601 `OffsetDateTime` serialization):
+
+```java
+import com.docusign.iam.sdk.utils.JSON;
+
+String json = JSON.getMapper().writeValueAsString(response);
+```
+
+To compose with your own `ObjectMapper`, register the provided `IamSDKJacksonModule`, which
+bundles all the same modules and feature flags as a single plug-and-play module:
+
+```java
+import com.docusign.iam.sdk.utils.IamSDKJacksonModule;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+ObjectMapper myMapper = new ObjectMapper()
+    .registerModule(new IamSDKJacksonModule());
+
+String json = myMapper.writeValueAsString(response);
+```
+
+[jackson-databind]: https://github.com/FasterXML/jackson-databind
+[jackson-jsr310]: https://github.com/FasterXML/jackson-modules-java8/tree/master/datetime
+<!-- End Jackson Configuration [jackson] -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
 # Development

RELEASES.md

@@ -87,4 +87,14 @@ Based on:
 ### Generated
 - [java v1.0.0-beta.8] .
 ### Releases
-- [Maven Central v1.0.0-beta.8] https://central.sonatype.com/artifact/com.docusign/iam-sdk/1.0.0-beta.8 - .
+- [Maven Central v1.0.0-beta.8] https://central.sonatype.com/artifact/com.docusign/iam-sdk/1.0.0-beta.8 - .
+
+## 2026-05-11 07:15:00
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.762.0 (2.882.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v1.0.0-beta.9] .
+### Releases
+- [Maven Central v1.0.0-beta.9] https://central.sonatype.com/artifact/com.docusign/iam-sdk/1.0.0-beta.9 - .

USAGE.md

@@ -19,7 +19,7 @@ public class Application {
                 .call();
 
         if (res.userInfo().isPresent()) {
-            // handle response
+            System.out.println(res.userInfo().get());
         }
     }
 }

docs/models/components/Actions.md

@@ -0,0 +1,10 @@
+# Actions
+
+Available actions on the agreement.
+
+
+## Fields
+
+| Field                                                                                                                | Type                                                                                                                 | Required                                                                                                             | Description                                                                                                          |
+| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `changeType`                                                                                                         | [Optional\<ChangeAgreementTypeResponseChangeType>](../../models/components/ChangeAgreementTypeResponseChangeType.md) | :heavy_minus_sign:                                                                                                   | N/A                                                                                                                  |