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,746 changes: 1,403 additions & 1,343 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.759.3
sources:
StackOne-OAS:
sourceNamespace: stackone-oas
sourceRevisionDigest: sha256:d2921c8d9bb771eec8c6c78397f98e56ff4a06e1e2c828e430d50d3bb21ce6ad
sourceBlobDigest: sha256:e78c042dc85efb074fe2055c1d6d7a4a7a029c3d442f35a4f0f1d37f46c37c68
sourceRevisionDigest: sha256:eb9f5a57ee0f6f03f9cf6ef29c610c5c1bf132667dda67a04a5507689d169352
sourceBlobDigest: sha256:8fd2560dd3b7b8e575f7b3539c526222975bce4368b8215a2d81a55cba5ff008
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:eb9f5a57ee0f6f03f9cf6ef29c610c5c1bf132667dda67a04a5507689d169352
sourceBlobDigest: sha256:8fd2560dd3b7b8e575f7b3539c526222975bce4368b8215a2d81a55cba5ff008
codeSamplesNamespace: stack-one-oas-java-code-samples
codeSamplesRevisionDigest: sha256:8627bd2455b96e44b7e24edcde9936a240c96568c0a3299283cdc7fffaae319d
codeSamplesRevisionDigest: sha256:e3373ef7625b1b2586ac7a3a2b4009a46da51d1cb00fff8fb44b6bbfbdeac26a
workflow:
workflowVersion: 1.0.0
speakeasyVersion: latest
Expand Down
81 changes: 66 additions & 15 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 @@ -206,7 +227,7 @@ public class Application {
* [getAccount](docs/sdks/accounts/README.md#getaccount) - Get Account
* [deleteAccount](docs/sdks/accounts/README.md#deleteaccount) - Delete Account
* [updateAccount](docs/sdks/accounts/README.md#updateaccount) - Update Account
* [getAccountMetaInfo](docs/sdks/accounts/README.md#getaccountmetainfo) - Get Account Meta Information
* [~~getAccountMetaInfo~~](docs/sdks/accounts/README.md#getaccountmetainfo) - Get Account Meta Information (Legacy) :warning: **Deprecated**

### [Actions](docs/sdks/actions/README.md)

Expand Down Expand Up @@ -299,10 +320,10 @@ public class Application {
* [createConnectSession](docs/sdks/connectsessions/README.md#createconnectsession) - Create Connect Session
* [authenticateConnectSession](docs/sdks/connectsessions/README.md#authenticateconnectsession) - Authenticate Connect Session

### [Connectors](docs/sdks/connectors/README.md)
### [~~Connectors~~](docs/sdks/connectors/README.md)

* [listConnectorsMeta](docs/sdks/connectors/README.md#listconnectorsmeta) - List Connector Meta Information
* [getConnectorMeta](docs/sdks/connectors/README.md#getconnectormeta) - Get Connector Meta Information
* [~~listConnectorsMeta~~](docs/sdks/connectors/README.md#listconnectorsmeta) - List Connector Meta Information (Legacy) :warning: **Deprecated**
* [~~getConnectorMeta~~](docs/sdks/connectors/README.md#getconnectormeta) - Get Connector Meta Information (Legacy) :warning: **Deprecated**

### [Crm](docs/sdks/crm/README.md)

Expand Down Expand Up @@ -493,9 +514,9 @@ public class Application {
* [getMessage](docs/sdks/messaging/README.md#getmessage) - Get Message
* [sendMessage](docs/sdks/messaging/README.md#sendmessage) - Send Message

### [Proxy](docs/sdks/proxy/README.md)
### [~~Proxy~~](docs/sdks/proxy/README.md)

* [proxyRequest](docs/sdks/proxy/README.md#proxyrequest) - Proxy Request
* [~~proxyRequest~~](docs/sdks/proxy/README.md#proxyrequest) - Proxy Request (Legacy) :warning: **Deprecated**

### [RequestLogs](docs/sdks/requestlogs/README.md)

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-28 00:10:44
### Changes
Based on:
- OpenAPI Doc
- Speakeasy CLI 1.759.3 (2.869.25) 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
Loading