chore: 🐝 Update SDK - Generate 0.3.0 (#11)

> [!IMPORTANT]
> Linting report available at:
<https://app.speakeasy.com/org/vanta/vanta/linting-report/3e8f9bd9fb3d3cd5d5ee445c9799ed50>
# SDK update
Based on:
- OpenAPI Doc  
- Speakeasy CLI 1.583.0 (2.658.3)
https://github.com/speakeasy-api/speakeasy
## Versioning

Version Bump Type: [minor] - 🤖 (automated)
## JAVA CHANGELOG
## core: 3.44.0 - 2025-07-08
### 🐝 New Features
- separate logging section from installation in Java v2 SDK README
*(commit by [@AshGodfrey](https://github.com/AshGodfrey))*



## core: 3.43.0 - 2025-07-05
### 🐝 New Features
- support null friendly parameters in methods and builders *(commit by
[@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.42.3 - 2025-07-03
### 🐛 Bug Fixes
- avoid relying on gradle java toolchains *(commit by
[@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.42.2 - 2025-07-02
### 🐛 Bug Fixes
- handle NPE cases when no globals are defined in the spec *(commit by
[@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.42.1 - 2025-07-01
### 🐛 Bug Fixes
- java toolchain language version in build.gradle *(commit by
[@davidmoten](https://github.com/davidmoten))*



## core: 3.42.0 - 2025-07-01
### 🐝 New Features
- java - enhance equals/hashCode to support mathematical equivalence
*(commit by [@davidmoten](https://github.com/davidmoten))*



## core: 3.41.0 - 2025-06-27
### 🐝 New Features
- set java language version *(commit by
[@walker-tx](https://github.com/walker-tx))*



## core: 3.40.1 - 2025-06-27
### 🐛 Bug Fixes
- revert java version setting *(commit by
[@walker-tx](https://github.com/walker-tx))*



## core: 3.40.0 - 2025-06-26
### 🐝 New Features
- select java language version *(commit by
[@walker-tx](https://github.com/walker-tx))*



## core: 3.39.1 - 2025-06-23
### 🔧 Chores
- introduce standalone Operation classes for encapsulating operation
logic *(commit by [@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.39.0 - 2025-06-12
### 🐝 New Features
- use singleton http client *(commit by
[@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.38.0 - 2025-06-10
### 🐝 New Features
- support custom code regions *(commit by
[@vishalg0wda](https://github.com/vishalg0wda))*



## core: 3.37.5 - 2025-06-06
### 🐛 Bug Fixes
- add support for arrays of files in multipart forms *(commit by
[@TristanSpeakEasy](https://github.com/tristanspeakeasy))*



## core: 3.37.4 - 2025-05-30
### 🐛 Bug Fixes
- include packageName in config metadata definitions, fix javadoc
warnings *(commit by [@davidmoten](https://github.com/davidmoten))*



## core: 3.37.3 - 2025-05-07
### 🐛 Bug Fixes
- fixed stability of generated examples using operation and field seeds,
including fixes to union examples *(commit by
[@TristanSpeakEasy](https://github.com/tristanspeakeasy))*



## core: 3.37.2 - 2025-04-30
### 🐛 Bug Fixes
- java - generate snippets for compilation test after parallel jobs run
*(commit by [@davidmoten](https://github.com/davidmoten))*



## globalSecurity: 2.83.0 - 2025-06-25
### 🐝 New Features
- use environment variables for API keys/secrets in usage snippets
*(commit by [@sheldonvaughn](https://github.com/sheldonvaughn))*



## globalServerURLs: 2.82.2 - 2025-05-09
### 🐛 Bug Fixes
- fixed issue with cached templated server url *(commit by
[@TristanSpeakEasy](https://github.com/tristanspeakeasy))*



## sdkHooks: 1.1.0 - 2025-05-12
### 🐝 New Features
- add support for accessing sdk configuration in hooks *(commit by
[@TristanSpeakEasy](https://github.com/tristanspeakeasy))*

---------

Co-authored-by: speakeasybot <[email protected]>
Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>

Author: 3 people

.gitignore

@@ -1,3 +1,5 @@
+**/.speakeasy/temp/
+**/.speakeasy/logs/
 # Ignore Gradle project-specific cache directory
 .gradle
 # Ignore Gradle build output directory

.speakeasy/gen.lock

@@ -1,27 +1,27 @@
 lockVersion: 2.0.0
 id: f42d74f5-5725-46fa-b13c-649b7ef895c3
 management:
-  docChecksum: 1a2b10b336197dc97b4e05876d814f28
+  docChecksum: 32687d9ba29da014326cc097fdfff59d
   docVersion: 1.0.0
-  speakeasyVersion: 1.533.0
-  generationVersion: 2.578.0
-  releaseVersion: 0.2.0
-  configChecksum: 23d16b94689a0480c660cd212b26e69c
+  speakeasyVersion: 1.583.0
+  generationVersion: 2.658.3
+  releaseVersion: 0.3.0
+  configChecksum: 04772eab57280291f66f591afacc7c70
   repoURL: https://github.com/VantaInc/vanta-auditor-api-sdk-java.git
   published: true
 features:
   java:
     additionalDependencies: 0.1.0
     constsAndDefaults: 0.1.1
-    core: 3.37.1
+    core: 3.44.0
     flattening: 2.81.1
-    globalSecurity: 2.82.8
+    globalSecurity: 2.83.0
     globalSecurityCallbacks: 0.1.0
     globalSecurityFlattening: 0.1.0
-    globalServerURLs: 2.82.1
+    globalServerURLs: 2.82.2
     nameOverrides: 2.81.3
     nullables: 0.1.0
-    sdkHooks: 1.0.0
+    sdkHooks: 1.1.0
     unions: 0.0.6
 generatedFiles:
   - .gitattributes
@@ -33,6 +33,7 @@ generatedFiles:
   - docs/models/components/AuditEvidenceState.md
   - docs/models/components/AuditEvidenceType.md
   - docs/models/components/AuditEvidenceUpdateInput.md
+  - docs/models/components/AuditFocus.md
   - docs/models/components/Auditor.md
   - docs/models/components/AuditorControl.md
   - docs/models/components/AuditorEnabledStateTransition.md
@@ -108,6 +109,7 @@ generatedFiles:
   - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditEvidenceState.java
   - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditEvidenceType.java
   - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditEvidenceUpdateInput.java
+  - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditFocus.java
   - src/main/java/com/vanta/vanta_auditor_api/models/components/Auditor.java
   - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditorControl.java
   - src/main/java/com/vanta/vanta_auditor_api/models/components/AuditorEnabledStateTransition.java
@@ -172,20 +174,33 @@ generatedFiles:
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/ListAuditsRequest.java
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/ListAuditsRequestBuilder.java
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/ListAuditsResponse.java
-  - src/main/java/com/vanta/vanta_auditor_api/models/operations/SDKMethodInterfaces.java
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/UpdateAuditEvidenceRequest.java
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/UpdateAuditEvidenceRequestBuilder.java
   - src/main/java/com/vanta/vanta_auditor_api/models/operations/UpdateAuditEvidenceResponse.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/CreateAuditorOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/CreateCommentForAuditEvidenceOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/CreateCustomControlOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/CreateCustomEvidenceRequestOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/ListAuditCommentsOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/ListAuditControlsOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/ListAuditEvidenceOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/ListAuditEvidenceUrlsOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/ListAuditsOperation.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/Operations.java
+  - src/main/java/com/vanta/vanta_auditor_api/operations/UpdateAuditEvidenceOperation.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/BackoffStrategy.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/BigDecimalString.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/BigIntegerString.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/Constants.java
+  - src/main/java/com/vanta/vanta_auditor_api/utils/CopiableInputStream.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/Deserializers.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/EventStream.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/EventStreamLineReader.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/EventStreamMessage.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/EventStreamReader.java
+  - src/main/java/com/vanta/vanta_auditor_api/utils/Exceptions.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/FormMetadata.java
+  - src/main/java/com/vanta/vanta_auditor_api/utils/Globals.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/HTTPClient.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/HTTPRequest.java
   - src/main/java/com/vanta/vanta_auditor_api/utils/HasSecurity.java
@@ -230,7 +245,7 @@ examples:
           pageSize: 10
       responses:
         "200":
-          application/json: {"results": {"data": [{"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56Z", "auditEndDate": "2024-03-14T21:25:56Z", "earlyAccessStartsDate": "2024-03-07T21:25:56Z", "framework": "SOC 2 Type II", "allowAuditorEmails": ["[email protected]"], "allowAllAuditors": true, "deletionDate": "2024-03-07T21:25:56Z", "creationDate": "2024-03-07T21:25:56Z", "modificationDate": "2024-03-07T21:25:56Z", "completionDate": "2024-03-07T21:25:56Z"}], "pageInfo": {"endCursor": "YXJyYXljb25uZWN0aW9uOjE=", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "YXJyYXljb25uZWN0aW9uOjA="}}}
+          application/json: {"results": {"data": [{"id": "65fc81a3359c8508c9af880f", "customerOrganizationName": "corporation.com", "customerDisplayName": "Corporation Company", "customerOrganizationId": "65fc81a3359c8508c9af880f", "auditStartDate": "2024-03-07T21:25:56Z", "auditEndDate": "2024-03-14T21:25:56Z", "earlyAccessStartsAt": "2024-03-07T21:25:56Z", "framework": "SOC 2 Type II", "allowAuditorEmails": ["[email protected]"], "allowAllAuditors": true, "deletionDate": "2024-03-07T21:25:56Z", "creationDate": "2024-03-07T21:25:56Z", "modificationDate": "2024-03-07T21:25:56Z", "completionDate": "2024-03-07T21:25:56Z", "auditFocus": "EXTERNAL"}], "pageInfo": {"endCursor": "YXJyYXljb25uZWN0aW9uOjE=", "hasNextPage": false, "hasPreviousPage": false, "startCursor": "YXJyYXljb25uZWN0aW9uOjA="}}}
   ListAuditEvidenceUrls:
     Example 1:
       parameters:
@@ -279,7 +294,7 @@ examples:
           auditId: "<id>"
           auditEvidenceId: "<id>"
       requestBody:
-        application/json: {"text": "<value>", "email": "Alexis74@hotmail.com", "creationDate": "2024-08-13T11:18:40.035Z"}
+        application/json: {"text": "<value>", "email": "Carmen.Bogan@yahoo.com", "creationDate": "2024-05-28T11:04:29.369Z"}
       responses:
         "200":
           application/json: {"id": "65fc81a3359c8508c9af880f", "auditEvidenceId": "65fc81a3359c8508c9af880f", "text": "Some comment", "creationDate": "2024-03-07T21:25:56Z", "modificationDate": "2024-03-07T21:25:56Z", "deletionDate": "2024-03-07T21:25:56Z", "email": "[email protected]"}
@@ -300,7 +315,7 @@ examples:
         path:
           auditId: "<id>"
       requestBody:
-        application/json: {"controlIds": ["<value>"], "title": "<value>", "description": "now whoa while", "cadence": "P3M", "reminderWindow": "P0D", "isRestricted": true, "auditorEmail": "<value>"}
+        application/json: {"controlIds": ["<value 1>", "<value 2>"], "title": "<value>", "description": "pure bludgeon deliberately question although", "cadence": "P1D", "reminderWindow": "P0D", "isRestricted": false, "auditorEmail": "<value>"}
       responses:
         "200":
           application/json: {"id": "65fc81a3359c8508c9af880f", "controlIds": ["1.1.2.a"], "title": "Access Control Policy", "description": "Description for Access Control Policy", "cadence": "P6M", "reminderWindow": "P6M", "isRestricted": true}
@@ -310,16 +325,16 @@ examples:
         path:
           auditId: "<id>"
       requestBody:
-        application/json: {"externalId": "<id>", "name": "<value>", "description": "even keenly afore mmm yearningly ouch tough yearly intent", "effectiveDate": "2024-07-08T11:52:30.590Z", "category": "THREAT_MANAGEMENT"}
+        application/json: {"externalId": "<id>", "name": null, "description": "yet plus utter queasily what juvenile wound", "effectiveDate": "2024-11-10T13:58:54.564Z", "category": "CLOUD_SECURITY"}
       responses:
         "201":
           application/json: {"id": "a2f7e1b9d0c3f4e5a6c7b8d9", "externalId": "CRY-104", "name": "Data encryption utilized", "description": "Access reviews are performed to ensure that access is appropriate for the user's role and responsibilities.", "source": "Vanta", "domains": ["CRYPTOGRAPHIC_PROTECTIONS"], "owner": {"id": "65e1efde08e8478f143a8ff9", "displayName": "Example Owner", "emailAddress": "[email protected]"}, "role": "CONTROLLER", "customFields": [{"label": "Additional context", "value": "This control is critical for GDPR compliance"}]}
   CreateAuditor:
     Example 1:
       requestBody:
-        application/json: {"email": "Loyal79@yahoo.com", "givenName": "<value>", "familyName": "<value>"}
+        application/json: {"email": "Genesis_Kunze87@yahoo.com", "givenName": "<value>", "familyName": "<value>"}
       responses:
         "200":
           application/json: {"id": "65fc81a3359c8508c9af880f", "organizationId": "8c9af880f1a335965fc850c8", "email": "[email protected]", "givenName": "Sam", "familyName": "Auditor"}
-examplesVersion: 1.0.1
+examplesVersion: 1.0.2
 generatedTests: {}

.speakeasy/gen.yaml

@@ -4,26 +4,35 @@ generation:
   maintainOpenAPIOrder: true
   usageSnippets:
     optionalPropertyRendering: withExample
+    sdkInitStyle: constructor
   useClassNamesForArrayFields: true
   fixes:
     nameResolutionDec2023: true
     nameResolutionFeb2025: false
     parameterOrderingFeb2024: true
     requestResponseComponentNamesFeb2024: true
     securityFeb2025: false
+    sharedErrorComponentsApr2025: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
+  tests:
+    generateTests: true
+    generateNewTests: false
+    skipResponseBodyAssertions: false
 java:
-  version: 0.2.0
+  version: 0.3.0
   additionalDependencies: []
   additionalPlugins: []
   artifactID: vanta-auditor-api
+  baseErrorName: VantaError
   clientServerStatusCodesAsErrors: true
   companyEmail: [email protected]
   companyName: Vanta
   companyURL: www.vanta.com
   defaultErrorName: APIException
+  enableAsync: false
+  enableCustomCodeRegions: false
   flattenGlobalSecurity: true
   githubURL: github.com/VantaInc/vanta-auditor-api-sdk-java
   groupID: com.vanta
@@ -36,11 +45,13 @@ java:
       shared: models/components
       webhooks: models/webhooks
   inputModelSuffix: input
+  languageVersion: 11
   license:
     name: The MIT License (MIT)
     shortName: MIT
     url: https://mit-license.org/
   maxMethodParams: 4
+  nullFriendlyParameters: false
   outputModelSuffix: output
   projectName: openapi
   templateVersion: v2

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.533.0
+speakeasyVersion: 1.583.0
 sources:
     Conduct an audit:
         sourceNamespace: conduct-an-audit
-        sourceRevisionDigest: sha256:fa49ac1c79f171ea6a2d1c947afc689d53fdcfacc6d0c758607d67082c43f3f7
-        sourceBlobDigest: sha256:bbe79169dea0b06f442a5b981fda5eb09f04b5ea369ef9832e48e6feabdccc08
+        sourceRevisionDigest: sha256:234b914b23cf5d74d33cd7077560a45c8cba13a211f3bd8344041648d8733c2d
+        sourceBlobDigest: sha256:8fefc2fa168b537a6f137983f6366a1d8abe9ea0a01bc6d108c601431b922a5b
         tags:
             - latest
-            - speakeasy-sdk-regen-1744825786
+            - speakeasy-sdk-regen-1752711959
             - 1.0.0
 targets:
     vanta:
         source: Conduct an audit
         sourceNamespace: conduct-an-audit
-        sourceRevisionDigest: sha256:fa49ac1c79f171ea6a2d1c947afc689d53fdcfacc6d0c758607d67082c43f3f7
-        sourceBlobDigest: sha256:bbe79169dea0b06f442a5b981fda5eb09f04b5ea369ef9832e48e6feabdccc08
+        sourceRevisionDigest: sha256:234b914b23cf5d74d33cd7077560a45c8cba13a211f3bd8344041648d8733c2d
+        sourceBlobDigest: sha256:8fefc2fa168b537a6f137983f6366a1d8abe9ea0a01bc6d108c601431b922a5b
         codeSamplesNamespace: conduct-an-audit-java-code-samples
-        codeSamplesRevisionDigest: sha256:3438586112f5de4156d99fa595eb77066b0fe12b05f8e0be4b0d1a1d8fe2618e
+        codeSamplesRevisionDigest: sha256:c37b408b3f4e67573812e3180585ed44685609283ecc89a119faafece26cadcc
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

README.md

@@ -25,6 +25,7 @@ Conduct an audit: The Auditor API lets audit firms conduct audits from a tool ou
   * [Available Resources and Operations](#available-resources-and-operations)
   * [Error Handling](#error-handling)
   * [Server Selection](#server-selection)
+  * [Debugging](#debugging)
 * [Development](#development)
   * [Maturity](#maturity)
   * [Contributions](#contributions)
@@ -43,15 +44,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.vanta:vanta-auditor-api:0.2.0'
+implementation 'com.vanta:vanta-auditor-api:0.3.0'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.vanta</groupId>
     <artifactId>vanta-auditor-api</artifactId>
-    <version>0.2.0</version>
+    <version>0.3.0</version>
 </dependency>
 ```
 
@@ -68,29 +69,6 @@ On Windows:
 ```bash
 gradlew.bat publishToMavenLocal -Pskip.signing
 ```
-
-### Logging
-A logging framework/facade has not yet been adopted but is under consideration.
-
-For request and response logging (especially json bodies) use:
-```java
-SpeakeasyHTTPClient.setDebugLogging(true); // experimental API only (may change without warning)
-```
-Example output:
-```
-Sending request: http://localhost:35123/bearer#global GET
-Request headers: {Accept=[application/json], Authorization=[******], Client-Level-Header=[added by client], Idempotency-Key=[some-key], x-speakeasy-user-agent=[speakeasy-sdk/java 0.0.1 internal 0.1.0 org.openapis.openapi]}
-Received response: (GET http://localhost:35123/bearer#global) 200
-Response headers: {access-control-allow-credentials=[true], access-control-allow-origin=[*], connection=[keep-alive], content-length=[50], content-type=[application/json], date=[Wed, 09 Apr 2025 01:43:29 GMT], server=[gunicorn/19.9.0]}
-Response body:
-{
-  "authenticated": true, 
-  "token": "global"
-}
-```
-WARNING: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
-
-Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
 <!-- End SDK Installation [installation] -->
 
 <!-- Start SDK Example Usage [usage] -->
@@ -110,10 +88,11 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Vanta sdk = Vanta.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAuditsResponse res = sdk.audits().list()
+                .pageSize(10)
                 .call();
 
         if (res.paginatedResponseAudit().isPresent()) {
@@ -148,10 +127,11 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Vanta sdk = Vanta.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAuditsResponse res = sdk.audits().list()
+                .pageSize(10)
                 .call();
 
         if (res.paginatedResponseAudit().isPresent()) {
@@ -213,10 +193,11 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Vanta sdk = Vanta.builder()
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAuditsResponse res = sdk.audits().list()
+                .pageSize(10)
                 .call();
 
         if (res.paginatedResponseAudit().isPresent()) {
@@ -255,10 +236,11 @@ public class Application {
 
         Vanta sdk = Vanta.builder()
                 .serverIndex(2)
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAuditsResponse res = sdk.audits().list()
+                .pageSize(10)
                 .call();
 
         if (res.paginatedResponseAudit().isPresent()) {
@@ -283,11 +265,12 @@ public class Application {
     public static void main(String[] args) throws Exception {
 
         Vanta sdk = Vanta.builder()
-                .serverURL("https://api.vanta.com/v1")
-                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
+                .serverURL("https://api.aus.vanta.com/v1")
+                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
             .build();
 
         ListAuditsResponse res = sdk.audits().list()
+                .pageSize(10)
                 .call();
 
         if (res.paginatedResponseAudit().isPresent()) {
@@ -298,6 +281,37 @@ public class Application {
 ```
 <!-- End Server Selection [server] -->
 
+<!-- Start Debugging [debug] -->
+## Debugging
+
+### Debug
+You can setup your SDK to emit debug logs for SDK requests and responses.
+
+For request and response logging (especially json bodies), call `enableHTTPDebugLogging(boolean)` on the SDK builder like so:
+```java
+SDK.builder()
+    .enableHTTPDebugLogging(true)
+    .build();
+```
+Example output:
+```
+Sending request: http://localhost:35123/bearer#global GET
+Request headers: {Accept=[application/json], Authorization=[******], Client-Level-Header=[added by client], Idempotency-Key=[some-key], x-speakeasy-user-agent=[speakeasy-sdk/java 0.0.1 internal 0.1.0 org.openapis.openapi]}
+Received response: (GET http://localhost:35123/bearer#global) 200
+Response headers: {access-control-allow-credentials=[true], access-control-allow-origin=[*], connection=[keep-alive], content-length=[50], content-type=[application/json], date=[Wed, 09 Apr 2025 01:43:29 GMT], server=[gunicorn/19.9.0]}
+Response body:
+{
+  "authenticated": true, 
+  "token": "global"
+}
+```
+__WARNING__: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
+
+__NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging()`. The `SpeakeasyHTTPClient` honors this setting. If you are using a custom HTTP client, it is up to the custom client to honor this setting.
+
+Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
+<!-- End Debugging [debug] -->
+
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
 # Development

RELEASES.md

@@ -8,4 +8,14 @@ Based on:
 ### Generated
 - [java v0.2.0] .
 ### Releases
-- [Maven Central v0.2.0] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.2.0 - .
+- [Maven Central v0.2.0] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.2.0 - .
+
+## 2025-07-21 00:27:31
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.583.0 (2.658.3) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v0.3.0] .
+### Releases
+- [Maven Central v0.3.0] https://central.sonatype.com/artifact/com.vanta/vanta-auditor-api/0.3.0 - .