Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
3 changes: 0 additions & 3 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -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
2,571 changes: 1,298 additions & 1,273 deletions .speakeasy/gen.lock

Large diffs are not rendered by default.

10 changes: 8 additions & 2 deletions .speakeasy/gen.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ generation:
securityFeb2025: false
sharedErrorComponentsApr2025: false
sharedNestedComponentsJan2026: false
nameOverrideFeb2026: false
auth:
oAuth2ClientCredentialsEnabled: false
oAuth2PasswordEnabled: false
Expand All @@ -28,7 +29,7 @@ generation:
generateNewTests: false
skipResponseBodyAssertions: false
java:
version: 0.19.2
version: 0.19.3
additionalDependencies: []
additionalPlugins: []
artifactID: stackone-client-java
Expand All @@ -40,12 +41,16 @@ java:
companyURL: www.stackone.com
defaultErrorName: SDKError
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.stackone
imports:
Expand All @@ -66,10 +71,11 @@ java:
maxMethodParams: 4
multipartArrayFormat: legacy
nullFriendlyParameters: false
openUnions: true
operationScopedParams: true
outputModelSuffix: output
prefixModeMethodNames: false
projectName: stackone-client-java
respectTitlesForPrimitiveUnionMembers: false
showSetterGetterTypesInDocs: false
templateVersion: v2
unionStrategy: populated-fields
13 changes: 6 additions & 7 deletions .speakeasy/workflow.lock
Original file line number Diff line number Diff line change
@@ -1,21 +1,20 @@
speakeasyVersion: 1.709.0
speakeasyVersion: 1.757.0
sources:
StackOne-OAS:
sourceNamespace: stackone-oas
sourceRevisionDigest: sha256:d2921c8d9bb771eec8c6c78397f98e56ff4a06e1e2c828e430d50d3bb21ce6ad
sourceBlobDigest: sha256:e78c042dc85efb074fe2055c1d6d7a4a7a029c3d442f35a4f0f1d37f46c37c68
sourceRevisionDigest: sha256:57cabc0f98102cce858018eb039004cb6eda8c8895f59ebc9be555cd9de95b0f
sourceBlobDigest: sha256:fd6dec035d81da0d5ea11c04d1704e3c4794182536193f8061b3c87e81418a68
tags:
- latest
- speakeasy-sdk-regen-1769645320
- 1.0.0
targets:
stackone:
source: StackOne-OAS
sourceNamespace: stackone-oas
sourceRevisionDigest: sha256:d2921c8d9bb771eec8c6c78397f98e56ff4a06e1e2c828e430d50d3bb21ce6ad
sourceBlobDigest: sha256:e78c042dc85efb074fe2055c1d6d7a4a7a029c3d442f35a4f0f1d37f46c37c68
sourceRevisionDigest: sha256:57cabc0f98102cce858018eb039004cb6eda8c8895f59ebc9be555cd9de95b0f
sourceBlobDigest: sha256:fd6dec035d81da0d5ea11c04d1704e3c4794182536193f8061b3c87e81418a68
codeSamplesNamespace: stack-one-oas-java-code-samples
codeSamplesRevisionDigest: sha256:8627bd2455b96e44b7e24edcde9936a240c96568c0a3299283cdc7fffaae319d
codeSamplesRevisionDigest: sha256:22e0390b4ce3dd7e0219a0d02639ec99e73b65801470939b2d27f0ee2ccbbee3
workflow:
workflowVersion: 1.0.0
speakeasyVersion: latest
Expand Down
69 changes: 60 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,18 @@
<!-- Start Summary [summary] -->
## Summary

Accounting: The documentation for the StackOne Unified API - ACCOUNTING
Accounting: The documentation for the StackOne API
The documentation for the StackOne Unified API - HRIS
The documentation for the StackOne Unified API - ATS
The documentation for the StackOne Unified API - CRM
The documentation for the StackOne Unified API - IAM
The documentation for the StackOne Unified API - MARKETING
The documentation for the StackOne Unified API - LMS
The documentation for the StackOne Unified API - TICKETING
The documentation for the StackOne Unified API - DOCUMENTS
The documentation for the StackOne Unified API - SCREENING
The documentation for the StackOne Unified API - MESSAGING
The documentation for the StackOne Unified API - ACCOUNTING
<!-- End Summary [summary] -->

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

Gradle:
```groovy
implementation 'com.stackone:stackone-client-java:0.19.2'
implementation 'com.stackone:stackone-client-java:0.19.3'
```

Maven:
```xml
<dependency>
<groupId>com.stackone</groupId>
<artifactId>stackone-client-java</artifactId>
<version>0.19.2</version>
<version>0.19.3</version>
</dependency>
```

Expand Down Expand Up @@ -171,14 +183,23 @@ public class Application {

resFut.thenAccept(res -> {
if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().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 Available Resources and Operations [operations] -->
Expand Down Expand Up @@ -725,7 +746,7 @@ public class Application {
.call();

if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().get());
}
}
}
Expand Down Expand Up @@ -792,7 +813,7 @@ public class Application {
.call();

if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().get());
}
}
}
Expand Down Expand Up @@ -868,7 +889,7 @@ public class Application {
.call();

if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().get());
}
} catch (StackOneError ex) { // all SDK exceptions inherit from StackOneError

Expand Down Expand Up @@ -994,7 +1015,7 @@ public class Application {
.call();

if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().get());
}
}
}
Expand Down Expand Up @@ -1126,7 +1147,7 @@ public class Application {
.call();

if (res.connectSessionTokenAuthLink().isPresent()) {
// handle response
System.out.println(res.connectSessionTokenAuthLink().get());
}
}
}
Expand Down Expand Up @@ -1335,6 +1356,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.stackone.stackone_client_java.utils.JSON;

String json = JSON.getMapper().writeValueAsString(response);
```

To compose with your own `ObjectMapper`, register the provided `StackoneClientJavaJacksonModule`, which
bundles all the same modules and feature flags as a single plug-and-play module:

```java
import com.stackone.stackone_client_java.utils.StackoneClientJavaJacksonModule;
import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper myMapper = new ObjectMapper()
.registerModule(new StackoneClientJavaJacksonModule());

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
Expand Down
12 changes: 11 additions & 1 deletion RELEASES.md
Original file line number Diff line number Diff line change
Expand Up @@ -338,4 +338,14 @@ Based on:
### Generated
- [java v0.19.2] .
### Releases
- [Maven Central v0.19.2] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.2 - .
- [Maven Central v0.19.2] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.2 - .

## 2026-03-18 00:11:24
### Changes
Based on:
- OpenAPI Doc
- Speakeasy CLI 1.757.0 (2.866.0) https://github.com/speakeasy-api/speakeasy
### Generated
- [java v0.19.3] .
### Releases
- [Maven Central v0.19.3] https://central.sonatype.com/artifact/com.stackone/stackone-client-java/0.19.3 - .
11 changes: 11 additions & 0 deletions docs/models/components/AccountAddressLocationTypeValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

The type of the location.

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountAddressLocationTypeValue;

AccountAddressLocationTypeValue value = AccountAddressLocationTypeValue.HOME;

// Open enum: use .of() to create instances from custom string values
AccountAddressLocationTypeValue custom = AccountAddressLocationTypeValue.of("custom_value");
```


## Values

Expand Down
11 changes: 11 additions & 0 deletions docs/models/components/AccountAddressValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

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

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountAddressValue;

AccountAddressValue value = AccountAddressValue.AF;

// Open enum: use .of() to create instances from custom string values
AccountAddressValue custom = AccountAddressValue.of("custom_value");
```


## Values

Expand Down
8 changes: 8 additions & 0 deletions docs/models/components/AccountingAccountActive2.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# AccountingAccountActive2

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingAccountActive2;

AccountingAccountActive2 value = AccountingAccountActive2.TRUE;
```


## Values

Expand Down
8 changes: 8 additions & 0 deletions docs/models/components/AccountingAccountResultActive2.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# AccountingAccountResultActive2

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingAccountResultActive2;

AccountingAccountResultActive2 value = AccountingAccountResultActive2.TRUE;
```


## Values

Expand Down
11 changes: 11 additions & 0 deletions docs/models/components/AccountingAccountResultValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Type of account

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingAccountResultValue;

AccountingAccountResultValue value = AccountingAccountResultValue.ASSET;

// Open enum: use .of() to create instances from custom string values
AccountingAccountResultValue custom = AccountingAccountResultValue.of("custom_value");
```


## Values

Expand Down
11 changes: 11 additions & 0 deletions docs/models/components/AccountingAccountValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Type of account

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingAccountValue;

AccountingAccountValue value = AccountingAccountValue.ASSET;

// Open enum: use .of() to create instances from custom string values
AccountingAccountValue custom = AccountingAccountValue.of("custom_value");
```


## Values

Expand Down
11 changes: 11 additions & 0 deletions docs/models/components/AccountingCompanyResultValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Default currency for the company

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingCompanyResultValue;

AccountingCompanyResultValue value = AccountingCompanyResultValue.AED;

// Open enum: use .of() to create instances from custom string values
AccountingCompanyResultValue custom = AccountingCompanyResultValue.of("custom_value");
```


## Values

Expand Down
11 changes: 11 additions & 0 deletions docs/models/components/AccountingCompanyValue.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@

Default currency for the company

## Example Usage

```java
import com.stackone.stackone_client_java.models.components.AccountingCompanyValue;

AccountingCompanyValue value = AccountingCompanyValue.AED;

// Open enum: use .of() to create instances from custom string values
AccountingCompanyValue custom = AccountingCompanyValue.of("custom_value");
```


## Values

Expand Down
Loading