Gusto
diff --git a/‎.speakeasy/logs/changes/changes.html‎
Lines changed: 1360 additions & 0 deletions b/‎.speakeasy/logs/changes/changes.html‎
Lines changed: 1360 additions & 0 deletions
diff --git a/‎.speakeasy/logs/changes/changes.md‎
Lines changed: 628 additions & 0 deletions b/‎.speakeasy/logs/changes/changes.md‎
Lines changed: 628 additions & 0 deletions
diff --git a/‎.speakeasy/logs/changes/new.openapi.yaml‎
Lines changed: 32958 additions & 0 deletions b/‎.speakeasy/logs/changes/new.openapi.yaml‎
Lines changed: 32958 additions & 0 deletions
diff --git a/‎.speakeasy/logs/changes/old.openapi.yaml‎
Lines changed: 31142 additions & 0 deletions b/‎.speakeasy/logs/changes/old.openapi.yaml‎
Lines changed: 31142 additions & 0 deletions
diff --git a/‎.speakeasy/workflow.lock‎
Lines changed: 6 additions & 7 deletions b/‎.speakeasy/workflow.lock‎
Lines changed: 6 additions & 7 deletions
diff --git a/‎gusto_embedded/.gitattributes‎
Lines changed: 0 additions & 3 deletions b/‎gusto_embedded/.gitattributes‎
Lines changed: 0 additions & 3 deletions
diff --git a/‎gusto_embedded/.speakeasy/gen.lock‎
Lines changed: 3211 additions & 2146 deletions b/‎gusto_embedded/.speakeasy/gen.lock‎
Lines changed: 3211 additions & 2146 deletions
diff --git a/‎gusto_embedded/.speakeasy/gen.yaml‎
Lines changed: 10 additions & 2 deletions b/‎gusto_embedded/.speakeasy/gen.yaml‎
Lines changed: 10 additions & 2 deletions
diff --git a/‎gusto_embedded/README.md‎
Lines changed: 63 additions & 21 deletions b/‎gusto_embedded/README.md‎
Lines changed: 63 additions & 21 deletions
diff --git a/‎gusto_embedded/RELEASES.md‎
Lines changed: 9 additions & 1 deletion b/‎gusto_embedded/RELEASES.md‎
Lines changed: 9 additions & 1 deletion
@@ -1,21 +1,20 @@
-speakeasyVersion: 1.692.0
+speakeasyVersion: 1.749.0
 sources:
     GustoEmbedded-OAS:
         sourceNamespace: gusto-embedded-oas
-        sourceRevisionDigest: sha256:830c753d02c15435169a357383c3757b9cf086825f7ebcb7ecbea75fd9d928a0
-        sourceBlobDigest: sha256:bc5e757c99f4bfb2a8e8081f377fae1b07eee46e9aea1d1dc08b618685afc86f
+        sourceRevisionDigest: sha256:353ac35f906604396561475a1069418f3d3cb45e22f98b31f8a2171bc0f762f3
+        sourceBlobDigest: sha256:b977914793fbc0c613dfaf6628f8415bc3788dd127ed5472f50f6af566df842d
         tags:
             - latest
-            - speakeasy-sdk-regen-1768522952
             - "2025-06-15"
 targets:
     gusto-embedded:
         source: GustoEmbedded-OAS
         sourceNamespace: gusto-embedded-oas
-        sourceRevisionDigest: sha256:830c753d02c15435169a357383c3757b9cf086825f7ebcb7ecbea75fd9d928a0
-        sourceBlobDigest: sha256:bc5e757c99f4bfb2a8e8081f377fae1b07eee46e9aea1d1dc08b618685afc86f
+        sourceRevisionDigest: sha256:353ac35f906604396561475a1069418f3d3cb45e22f98b31f8a2171bc0f762f3
+        sourceBlobDigest: sha256:b977914793fbc0c613dfaf6628f8415bc3788dd127ed5472f50f6af566df842d
         codeSamplesNamespace: gusto-embedded-oas-java-code-samples
-        codeSamplesRevisionDigest: sha256:d2af391897b29300b26571ba0f2713bcc06569178a238dcb179bef6a7a4d91ca
+        codeSamplesRevisionDigest: sha256:75ae537b97b946678357c93110d02d9a4412cdd99daaf41d749de42b18a43702
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest
 
@@ -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
@@ -14,20 +14,22 @@ generation:
     securityFeb2025: true
     sharedErrorComponentsApr2025: false
     sharedNestedComponentsJan2026: false
+    nameOverrideFeb2026: false
   auth:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
     hoistGlobalSecurity: true
   schemas:
     allOfMergeStrategy: shallowMerge
   requestBodyFieldName: ""
+  versioningStrategy: automatic
   persistentEdits: {}
   tests:
     generateTests: true
     generateNewTests: false
     skipResponseBodyAssertions: false
 java:
-  version: 0.3.1
+  version: 0.3.2
   additionalDependencies: []
   additionalPlugins: []
   artifactID: embedded-api
@@ -39,12 +41,16 @@ java:
   companyURL: www.mycompany.com
   defaultErrorName: APIException
   enableCustomCodeRegions: false
+  enableFormatting: false
   enableSlf4jLogging: false
   enableStreamingUploads: false
+  explicitDocImports: false
   flattenGlobalSecurity: true
   forwardCompatibleEnumsByDefault: false
+  forwardCompatibleUnionsByDefault: "false"
   generateOptionalUnionAccessors: false
   generateSpringBootStarter: true
+  generateUnionDocs: false
   githubURL: github.com/owner/repo
   groupID: com.gusto
   imports:
@@ -65,9 +71,11 @@ java:
   maxMethodParams: 4
   multipartArrayFormat: legacy
   nullFriendlyParameters: false
-  openUnions: false
   operationScopedParams: true
   outputModelSuffix: output
+  prefixModeMethodNames: false
   projectName: GustoEmbedded
+  respectTitlesForPrimitiveUnionMembers: false
+  showSetterGetterTypesInDocs: false
   templateVersion: v2
   unionStrategy: populated-fields
@@ -33,6 +33,7 @@ Gusto API: Welcome to Gusto's Embedded Payroll API documentation!
   * [Server Selection](#server-selection)
   * [Custom HTTP Client](#custom-http-client)
   * [Debugging](#debugging)
+  * [Jackson Configuration](#jackson-configuration)
 * [Development](#development)
   * [Maturity](#maturity)
   * [Contributions](#contributions)
@@ -50,15 +51,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.gusto:embedded-api:0.3.1'
+implementation 'com.gusto:embedded-api:0.3.2'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.gusto</groupId>
     <artifactId>embedded-api</artifactId>
-    <version>0.3.1</version>
+    <version>0.3.2</version>
 </dependency>
 ```
 
@@ -103,7 +104,7 @@ public class Application {
                 .call();
 
         if (res.object().isPresent()) {
-            // handle response
+            System.out.println(res.object().get());
         }
     }
 }
@@ -134,14 +135,23 @@ public class Application {
 
         resFut.thenAccept(res -> {
             if (res.object().isPresent()) {
-            // handle response
+                System.out.println(res.object().get());
             }
         });
     }
 }
 ```
 
 [comp-fut]: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
+
+#### 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 Asynchronous Support [async-support] -->
@@ -243,7 +253,7 @@ public class Application {
                 .call();
 
         if (res.object().isPresent()) {
-            // handle response
+            System.out.println(res.object().get());
         }
     }
 }
@@ -290,7 +300,7 @@ public class Application {
                 .call();
 
         if (res.object().isPresent()) {
-            // handle response
+            System.out.println(res.object().get());
         }
     }
 }
@@ -320,12 +330,12 @@ public class Application {
 * [createPartnerManaged](docs/sdks/companies/README.md#createpartnermanaged) - Create a partner managed company
 * [get](docs/sdks/companies/README.md#get) - Get a company
 * [update](docs/sdks/companies/README.md#update) - Update a company
-* [migrate](docs/sdks/companies/README.md#migrate) - Migrate company to embedded payroll
+* [getV1PartnerManagedCompaniesCompanyUuidMigrationReadiness](docs/sdks/companies/README.md#getv1partnermanagedcompaniescompanyuuidmigrationreadiness) - Check company migration readiness
 * [acceptTermsOfService](docs/sdks/companies/README.md#accepttermsofservice) - Accept terms of service for a company user
 * [retrieveTermsOfService](docs/sdks/companies/README.md#retrievetermsofservice) - Retrieve terms of service status for a company user
 * [createAdmin](docs/sdks/companies/README.md#createadmin) - Create an admin for the company
 * [listAdmins](docs/sdks/companies/README.md#listadmins) - Get all the admins at a company
-* [getOnboardingStatus](docs/sdks/companies/README.md#getonboardingstatus) - Get the company's onboarding status
+* [getOnboardingStatus](docs/sdks/companies/README.md#getonboardingstatus) - Get company onboarding status
 * [finishOnboarding](docs/sdks/companies/README.md#finishonboarding) - Finish company onboarding
 * [getCustomFields](docs/sdks/companies/README.md#getcustomfields) - Get the custom fields of a company
 
@@ -511,7 +521,7 @@ public class Application {
 * [update](docs/sdks/employees/README.md#update) - Update an employee.
 * [delete](docs/sdks/employees/README.md#delete) - Delete an onboarding employee
 * [getCustomFields](docs/sdks/employees/README.md#getcustomfields) - Get an employee's custom fields
-* [updateOnboardingDocumentsConfig](docs/sdks/employees/README.md#updateonboardingdocumentsconfig) - Update an employee's onboarding documents config
+* [updateOnboardingDocumentsConfig](docs/sdks/employees/README.md#updateonboardingdocumentsconfig) - Update employee onboarding documents config
 * [getOnboardingStatus](docs/sdks/employees/README.md#getonboardingstatus) - Get the employee's onboarding status
 * [updateOnboardingStatus](docs/sdks/employees/README.md#updateonboardingstatus) - Update the employee's onboarding status
 * [getTimeOffActivities](docs/sdks/employees/README.md#gettimeoffactivities) - Get employee time off activities
@@ -597,7 +607,7 @@ public class Application {
 ### [Introspection](docs/sdks/introspection/README.md)
 
 * [getInfo](docs/sdks/introspection/README.md#getinfo) - Get info about the current access token
-* [oauthAccessToken](docs/sdks/introspection/README.md#oauthaccesstoken) - create or refresh an access token
+* [oauthAccessToken](docs/sdks/introspection/README.md#oauthaccesstoken) - Create a System Access Token or Refresh an Access Token
 
 ### [Invoices](docs/sdks/invoices/README.md)
 
@@ -619,7 +629,7 @@ public class Application {
 ### [Locations](docs/sdks/locations/README.md)
 
 * [create](docs/sdks/locations/README.md#create) - Create a company location
-* [get](docs/sdks/locations/README.md#get) - Get company locations
+* [get](docs/sdks/locations/README.md#get) - Get all company locations
 * [retrieve](docs/sdks/locations/README.md#retrieve) - Get a location
 * [update](docs/sdks/locations/README.md#update) - Update a location
 * [getMinimumWages](docs/sdks/locations/README.md#getminimumwages) - Get minimum wages for a location
@@ -645,6 +655,9 @@ public class Application {
 * [prepare](docs/sdks/payrolls/README.md#prepare) - Prepare a payroll for update
 * [getReceipt](docs/sdks/payrolls/README.md#getreceipt) - Get a single payroll receipt
 * [getBlockers](docs/sdks/payrolls/README.md#getblockers) - Get all payroll blockers for a company
+* [calculateGrossUp](docs/sdks/payrolls/README.md#calculategrossup) - Calculate gross up for a payroll
+* [calculate](docs/sdks/payrolls/README.md#calculate) - Calculate a payroll
+* [submit](docs/sdks/payrolls/README.md#submit) - Submit payroll
 * [cancel](docs/sdks/payrolls/README.md#cancel) - Cancel a payroll
 * [getPayStub](docs/sdks/payrolls/README.md#getpaystub) - Get an employee pay stub (pdf)
 * [getPayStubs](docs/sdks/payrolls/README.md#getpaystubs) - Get an employee's pay stubs
@@ -807,7 +820,7 @@ public class Application {
                     .call();
 
             if (res.object().isPresent()) {
-                // handle response
+                System.out.println(res.object().get());
             }
         } catch (GustoEmbeddedException ex) { // all SDK exceptions inherit from GustoEmbeddedException
 
@@ -848,7 +861,7 @@ public class Application {
 **Primary error:**
 * [`GustoEmbeddedException`](./src/main/java/models/errors/GustoEmbeddedException.java): The base class for HTTP error responses.
 
-<details><summary>Less common errors (12)</summary>
+<details><summary>Less common errors (11)</summary>
 
 <br />
 
@@ -858,12 +871,11 @@ public class Application {
 many more subclasses in the JDK platform).
 
 **Inherit from [`GustoEmbeddedException`](./src/main/java/models/errors/GustoEmbeddedException.java)**:
-* [`com.gusto.embedded_api.models.errors.UnprocessableEntityErrorObject`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.UnprocessableEntityErrorObject.java): Unprocessable Entity    This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details. Applicable to 164 of 277 methods.*
-* [`com.gusto.embedded_api.models.errors.NotFoundErrorObject`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.NotFoundErrorObject.java): Not Found     The requested resource does not exist. Make sure the provided ID/UUID is valid. Status code `404`. Applicable to 4 of 277 methods.*
-* [`com.gusto.embedded_api.models.errors.PostV1CompaniesCompanyIdPeopleBatchesResponseBody`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.PostV1CompaniesCompanyIdPeopleBatchesResponseBody.java): conflict - idempotency key already used. Status code `409`. Applicable to 1 of 277 methods.*
-* [`com.gusto.embedded_api.models.errors.GetCompaniesCompanyUuidContractorPaymentsPreviewResponseBody`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.GetCompaniesCompanyUuidContractorPaymentsPreviewResponseBody.java): Unprocessable Entity (WebDAV). Status code `422`. Applicable to 1 of 277 methods.*
-* [`com.gusto.embedded_api.models.errors.DeleteV1CompanyBenefitsCompanyBenefitIdResponseBody`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.DeleteV1CompanyBenefitsCompanyBenefitIdResponseBody.java): Unprocessable Entity. Status code `422`. Applicable to 1 of 277 methods.*
-* [`com.gusto.embedded_api.models.errors.CompanySuspensionCreationErrors`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.CompanySuspensionCreationErrors.java): Unprocessable Entity    This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details. Status code `422`. Applicable to 1 of 277 methods.*
+* [`com.gusto.embedded_api.models.errors.UnprocessableEntityErrorObject`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.UnprocessableEntityErrorObject.java): Unprocessable Entity    This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details. Applicable to 144 of 280 methods.*
+* [`com.gusto.embedded_api.models.errors.NotFoundErrorObject`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.NotFoundErrorObject.java): Not Found     The requested resource does not exist. Make sure the provided ID/UUID is valid. Applicable to 101 of 280 methods.*
+* [`com.gusto.embedded_api.models.errors.PostV1CompaniesCompanyIdPeopleBatchesResponseBody`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.PostV1CompaniesCompanyIdPeopleBatchesResponseBody.java): conflict - idempotency key already used. Status code `409`. Applicable to 1 of 280 methods.*
+* [`com.gusto.embedded_api.models.errors.GetCompaniesCompanyUuidContractorPaymentsPreviewResponseBody`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.GetCompaniesCompanyUuidContractorPaymentsPreviewResponseBody.java): Unprocessable Entity (WebDAV). Status code `422`. Applicable to 1 of 280 methods.*
+* [`com.gusto.embedded_api.models.errors.CompanySuspensionCreationErrors`](./src/main/java/models/errors/com.gusto.embedded_api.models.errors.CompanySuspensionCreationErrors.java): Unprocessable Entity    This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details. Status code `422`. Applicable to 1 of 280 methods.*
 
 
 </details>
@@ -907,7 +919,7 @@ public class Application {
                 .call();
 
         if (res.object().isPresent()) {
-            // handle response
+            System.out.println(res.object().get());
         }
     }
 }
@@ -938,7 +950,7 @@ public class Application {
                 .call();
 
         if (res.object().isPresent()) {
-            // handle response
+            System.out.println(res.object().get());
         }
     }
 }
@@ -1115,6 +1127,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.gusto.embedded_api.utils.JSON;
+
+String json = JSON.getMapper().writeValueAsString(response);
+```
+
+To compose with your own `ObjectMapper`, register the provided `GustoEmbeddedJacksonModule`, which
+bundles all the same modules and feature flags as a single plug-and-play module:
+
+```java
+import com.gusto.embedded_api.utils.GustoEmbeddedJacksonModule;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+ObjectMapper myMapper = new ObjectMapper()
+    .registerModule(new GustoEmbeddedJacksonModule());
+
+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
 
@@ -70,4 +70,12 @@ Based on:
 - OpenAPI Doc  
 - Speakeasy CLI 1.692.0 (2.797.1) https://github.com/speakeasy-api/speakeasy
 ### Generated
-- [java v0.3.1] gusto_embedded
+- [java v0.3.1] gusto_embedded
+
+## 2026-03-08 00:26:45
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.749.0 (2.855.2) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v0.3.2] gusto_embedded