Skip to content

Commit dc08a9f

Browse files
committed
## Java SDK Changes:
* `stackone.hris.batchUploadEmployeeDocument()`: `request.prefer` **Removed** (Breaking ⚠️) * `stackone.ticketing.downloadTicketingAttachment()`: * `request.prefer` **Removed** (Breaking ⚠️) * `stackone.messaging.downloadMessagingAttachment()`: * `request.prefer` **Removed** (Breaking ⚠️) * `stackone.documents.uploadFile()`: `request.prefer` **Removed** (Breaking ⚠️) * `stackone.mcp.mcpPost()`: `request` **Changed** (Breaking ⚠️) * `stackone.documents.downloadFile()`: * `request.prefer` **Removed** (Breaking ⚠️) * `stackone.actions.searchActions()`: * `request.minSimilarity` **Added** * `response.results[]` **Changed** (Breaking ⚠️) * `stackone.actions.rpcAction()`: `request` **Changed** (Breaking ⚠️) * `stackone.ats.downloadApplicationDocument()`: * `request.prefer` **Removed** (Breaking ⚠️) * `stackone.hris.downloadEmployeeDocument()`: * `request.prefer` **Removed** (Breaking ⚠️) * `stackone.hris.uploadEmployeeDocument()`: `request.prefer` **Removed** (Breaking ⚠️) * `stackone.ats.uploadApplicationDocument()`: `request.prefer` **Removed** (Breaking ⚠️) * `stackone.accounts.getAccount()`: `response.shared` **Added** * `stackone.accounts.listLinkedAccounts()`: `response.[].shared` **Added** * `stackone.actions.listActionsMeta()`: `response.data[].authentication[].support.guides.config.sections[]` **Changed** * `stackone.accounts.updateAccount()`: * `request.patchAccountExternalDto.shared` **Added** * `response.shared` **Added** * `stackone.documents.listFolders()`: * `request.filter` **Changed** * `stackone.accounts.deleteAccount()`: `response.shared` **Added**
1 parent e3a1a7a commit dc08a9f

File tree

668 files changed

+8727
-3520
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

668 files changed

+8727
-3520
lines changed

.gitattributes

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,5 @@
44
# Linux start script should use lf
55
/gradlew text eol=lf
66

7-
# These are Windows script files and should use crlf
8-
*.bat text eol=crlf
9-
107
# This allows generated code to be indexed correctly
118
*.java linguist-generated=false

.speakeasy/gen.lock

Lines changed: 1382 additions & 1322 deletions
Large diffs are not rendered by default.

.speakeasy/gen.yaml

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ generation:
1414
securityFeb2025: false
1515
sharedErrorComponentsApr2025: false
1616
sharedNestedComponentsJan2026: false
17+
nameOverrideFeb2026: false
1718
auth:
1819
oAuth2ClientCredentialsEnabled: false
1920
oAuth2PasswordEnabled: false
@@ -28,7 +29,7 @@ generation:
2829
generateNewTests: false
2930
skipResponseBodyAssertions: false
3031
java:
31-
version: 0.19.2
32+
version: 0.19.3
3233
additionalDependencies: []
3334
additionalPlugins: []
3435
artifactID: stackone-client-java
@@ -40,12 +41,16 @@ java:
4041
companyURL: www.stackone.com
4142
defaultErrorName: SDKError
4243
enableCustomCodeRegions: false
44+
enableFormatting: false
4345
enableSlf4jLogging: false
4446
enableStreamingUploads: false
47+
explicitDocImports: false
4548
flattenGlobalSecurity: true
4649
forwardCompatibleEnumsByDefault: false
50+
forwardCompatibleUnionsByDefault: "false"
4751
generateOptionalUnionAccessors: false
4852
generateSpringBootStarter: true
53+
generateUnionDocs: false
4954
githubURL: github.com/owner/repo
5055
groupID: com.stackone
5156
imports:
@@ -66,10 +71,11 @@ java:
6671
maxMethodParams: 4
6772
multipartArrayFormat: legacy
6873
nullFriendlyParameters: false
69-
openUnions: true
7074
operationScopedParams: true
7175
outputModelSuffix: output
76+
prefixModeMethodNames: false
7277
projectName: stackone-client-java
7378
respectTitlesForPrimitiveUnionMembers: false
79+
showSetterGetterTypesInDocs: false
7480
templateVersion: v2
7581
unionStrategy: populated-fields

.speakeasy/workflow.lock

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
1-
speakeasyVersion: 1.709.0
1+
speakeasyVersion: 1.759.2
22
sources:
33
StackOne-OAS:
44
sourceNamespace: stackone-oas
5-
sourceRevisionDigest: sha256:d2921c8d9bb771eec8c6c78397f98e56ff4a06e1e2c828e430d50d3bb21ce6ad
6-
sourceBlobDigest: sha256:e78c042dc85efb074fe2055c1d6d7a4a7a029c3d442f35a4f0f1d37f46c37c68
5+
sourceRevisionDigest: sha256:0a4e242d0aa1680b45c370283bf8542b396152f1083281554dc520842f90badd
6+
sourceBlobDigest: sha256:e82c3c452ddf4ea65ecc0826fc56c15855519fc0d98e693ef1366c0bb7285b7e
77
tags:
88
- latest
9-
- speakeasy-sdk-regen-1769645320
109
- 1.0.0
1110
targets:
1211
stackone:
1312
source: StackOne-OAS
1413
sourceNamespace: stackone-oas
15-
sourceRevisionDigest: sha256:d2921c8d9bb771eec8c6c78397f98e56ff4a06e1e2c828e430d50d3bb21ce6ad
16-
sourceBlobDigest: sha256:e78c042dc85efb074fe2055c1d6d7a4a7a029c3d442f35a4f0f1d37f46c37c68
14+
sourceRevisionDigest: sha256:0a4e242d0aa1680b45c370283bf8542b396152f1083281554dc520842f90badd
15+
sourceBlobDigest: sha256:e82c3c452ddf4ea65ecc0826fc56c15855519fc0d98e693ef1366c0bb7285b7e
1716
codeSamplesNamespace: stack-one-oas-java-code-samples
18-
codeSamplesRevisionDigest: sha256:8627bd2455b96e44b7e24edcde9936a240c96568c0a3299283cdc7fffaae319d
17+
codeSamplesRevisionDigest: sha256:3fbff3f61119dd95fe45f411f84dfc5f1beba81d4d23f7ce9e0e021c8e3940d6
1918
workflow:
2019
workflowVersion: 1.0.0
2120
speakeasyVersion: latest

README.md

Lines changed: 60 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,18 @@
1111
<!-- Start Summary [summary] -->
1212
## Summary
1313

14-
Accounting: The documentation for the StackOne Unified API - ACCOUNTING
14+
Accounting: The documentation for the StackOne API
15+
The documentation for the StackOne Unified API - HRIS
16+
The documentation for the StackOne Unified API - ATS
17+
The documentation for the StackOne Unified API - CRM
18+
The documentation for the StackOne Unified API - IAM
19+
The documentation for the StackOne Unified API - MARKETING
20+
The documentation for the StackOne Unified API - LMS
21+
The documentation for the StackOne Unified API - TICKETING
22+
The documentation for the StackOne Unified API - DOCUMENTS
23+
The documentation for the StackOne Unified API - SCREENING
24+
The documentation for the StackOne Unified API - MESSAGING
25+
The documentation for the StackOne Unified API - ACCOUNTING
1526
<!-- End Summary [summary] -->
1627

1728
<!-- Start Table of Contents [toc] -->
@@ -29,6 +40,7 @@ Accounting: The documentation for the StackOne Unified API - ACCOUNTING
2940
* [Authentication](#authentication)
3041
* [Custom HTTP Client](#custom-http-client)
3142
* [Debugging](#debugging)
43+
* [Jackson Configuration](#jackson-configuration)
3244
* [Development](#development)
3345
* [Maturity](#maturity)
3446
* [Contributions](#contributions)
@@ -46,15 +58,15 @@ The samples below show how a published SDK artifact is used:
4658

4759
Gradle:
4860
```groovy
49-
implementation 'com.stackone:stackone-client-java:0.19.2'
61+
implementation 'com.stackone:stackone-client-java:0.19.3'
5062
```
5163

5264
Maven:
5365
```xml
5466
<dependency>
5567
<groupId>com.stackone</groupId>
5668
<artifactId>stackone-client-java</artifactId>
57-
<version>0.19.2</version>
69+
<version>0.19.3</version>
5870
</dependency>
5971
```
6072

@@ -171,14 +183,23 @@ public class Application {
171183

172184
resFut.thenAccept(res -> {
173185
if (res.connectSessionTokenAuthLink().isPresent()) {
174-
// handle response
186+
System.out.println(res.connectSessionTokenAuthLink().get());
175187
}
176188
});
177189
}
178190
}
179191
```
180192

181193
[comp-fut]: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
194+
195+
#### Union Consumption Patterns
196+
197+
When a response field is a union model:
198+
199+
- Discriminated unions: branch on the discriminator (`switch`) and then narrow to the concrete type.
200+
- Non-discriminated unions: use generated accessors (for example `string()`, `asLong()`, `simpleObject()`) to determine the active variant.
201+
202+
For full model-specific examples (including Java 11/16/21 variants), see each union model's **Supported Types** section in the generated model docs.
182203
<!-- End SDK Example Usage [usage] -->
183204

184205
<!-- Start Available Resources and Operations [operations] -->
@@ -725,7 +746,7 @@ public class Application {
725746
.call();
726747

727748
if (res.connectSessionTokenAuthLink().isPresent()) {
728-
// handle response
749+
System.out.println(res.connectSessionTokenAuthLink().get());
729750
}
730751
}
731752
}
@@ -792,7 +813,7 @@ public class Application {
792813
.call();
793814

794815
if (res.connectSessionTokenAuthLink().isPresent()) {
795-
// handle response
816+
System.out.println(res.connectSessionTokenAuthLink().get());
796817
}
797818
}
798819
}
@@ -868,7 +889,7 @@ public class Application {
868889
.call();
869890

870891
if (res.connectSessionTokenAuthLink().isPresent()) {
871-
// handle response
892+
System.out.println(res.connectSessionTokenAuthLink().get());
872893
}
873894
} catch (StackOneError ex) { // all SDK exceptions inherit from StackOneError
874895

@@ -994,7 +1015,7 @@ public class Application {
9941015
.call();
9951016

9961017
if (res.connectSessionTokenAuthLink().isPresent()) {
997-
// handle response
1018+
System.out.println(res.connectSessionTokenAuthLink().get());
9981019
}
9991020
}
10001021
}
@@ -1126,7 +1147,7 @@ public class Application {
11261147
.call();
11271148

11281149
if (res.connectSessionTokenAuthLink().isPresent()) {
1129-
// handle response
1150+
System.out.println(res.connectSessionTokenAuthLink().get());
11301151
}
11311152
}
11321153
}
@@ -1335,6 +1356,36 @@ __NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging
13351356
Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
13361357
<!-- End Debugging [debug] -->
13371358

1359+
<!-- Start Jackson Configuration [jackson] -->
1360+
## Jackson Configuration
1361+
1362+
The SDK ships with a pre-configured Jackson [`ObjectMapper`][jackson-databind] accessible via
1363+
`JSON.getMapper()`. It is set up with type modules, strict deserializers, and the feature flags
1364+
needed for full SDK compatibility (including ISO-8601 `OffsetDateTime` serialization):
1365+
1366+
```java
1367+
import com.stackone.stackone_client_java.utils.JSON;
1368+
1369+
String json = JSON.getMapper().writeValueAsString(response);
1370+
```
1371+
1372+
To compose with your own `ObjectMapper`, register the provided `StackoneClientJavaJacksonModule`, which
1373+
bundles all the same modules and feature flags as a single plug-and-play module:
1374+
1375+
```java
1376+
import com.stackone.stackone_client_java.utils.StackoneClientJavaJacksonModule;
1377+
import com.fasterxml.jackson.databind.ObjectMapper;
1378+
1379+
ObjectMapper myMapper = new ObjectMapper()
1380+
.registerModule(new StackoneClientJavaJacksonModule());
1381+
1382+
String json = myMapper.writeValueAsString(response);
1383+
```
1384+
1385+
[jackson-databind]: https://github.com/FasterXML/jackson-databind
1386+
[jackson-jsr310]: https://github.com/FasterXML/jackson-modules-java8/tree/master/datetime
1387+
<!-- End Jackson Configuration [jackson] -->
1388+
13381389
<!-- Placeholder for Future Speakeasy SDK Sections -->
13391390

13401391
# Development

RELEASES.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -338,4 +338,14 @@ Based on:
338338
### Generated
339339
- [java v0.19.2] .
340340
### Releases
341-
- [Maven Central v0.19.2] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.2 - .
341+
- [Maven Central v0.19.2] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.2 - .
342+
343+
## 2026-03-25 00:10:45
344+
### Changes
345+
Based on:
346+
- OpenAPI Doc
347+
- Speakeasy CLI 1.759.2 (2.869.23) https://github.com/speakeasy-api/speakeasy
348+
### Generated
349+
- [java v0.19.3] .
350+
### Releases
351+
- [Maven Central v0.19.3] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.3 - .

docs/models/components/AccountAddressLocationTypeValue.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,17 @@
22

33
The type of the location.
44

5+
## Example Usage
6+
7+
```java
8+
import com.stackone.stackone_client_java.models.components.AccountAddressLocationTypeValue;
9+
10+
AccountAddressLocationTypeValue value = AccountAddressLocationTypeValue.HOME;
11+
12+
// Open enum: use .of() to create instances from custom string values
13+
AccountAddressLocationTypeValue custom = AccountAddressLocationTypeValue.of("custom_value");
14+
```
15+
516

617
## Values
718

docs/models/components/AccountAddressValue.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,17 @@
22

33
The ISO 3166-1 alpha-2 code of the country.
44

5+
## Example Usage
6+
7+
```java
8+
import com.stackone.stackone_client_java.models.components.AccountAddressValue;
9+
10+
AccountAddressValue value = AccountAddressValue.AF;
11+
12+
// Open enum: use .of() to create instances from custom string values
13+
AccountAddressValue custom = AccountAddressValue.of("custom_value");
14+
```
15+
516

617
## Values
718

docs/models/components/AccountingAccountActive2.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# AccountingAccountActive2
22

3+
## Example Usage
4+
5+
```java
6+
import com.stackone.stackone_client_java.models.components.AccountingAccountActive2;
7+
8+
AccountingAccountActive2 value = AccountingAccountActive2.TRUE;
9+
```
10+
311

412
## Values
513

docs/models/components/AccountingAccountResultActive2.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# AccountingAccountResultActive2
22

3+
## Example Usage
4+
5+
```java
6+
import com.stackone.stackone_client_java.models.components.AccountingAccountResultActive2;
7+
8+
AccountingAccountResultActive2 value = AccountingAccountResultActive2.TRUE;
9+
```
10+
311

412
## Values
513

0 commit comments

Comments
 (0)