Skip to content

Commit 96bf0fc

Browse files
github-actions[bot]speakeasybotspeakeasy-github[bot]
authored
chore: 🐝 Update SDK - Generate 9.1.0 (#80)
* ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.768.2 * empty commit to trigger [run-tests] workflow --------- Co-authored-by: speakeasybot <bot@speakeasyapi.dev> Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
1 parent 9a7f3c5 commit 96bf0fc

541 files changed

Lines changed: 3153 additions & 14984 deletions

File tree

Some content is hidden

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

‎.speakeasy/gen.lock‎

Lines changed: 1078 additions & 1080 deletions
Large diffs are not rendered by default.

‎.speakeasy/workflow.lock‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,18 @@ sources:
99
- speakeasy-sdk-regen-1732202901
1010
stacks-source:
1111
sourceNamespace: stacks-source
12-
sourceRevisionDigest: sha256:8e24b24261d6d29c5d7c91f8756cb9e47d21d0a8297e6dbe2acf706410a84747
13-
sourceBlobDigest: sha256:d6ef9edab168ce242ff12833d07c2be33b42d4e66fa4159f5a4f12bc5a5543b3
12+
sourceRevisionDigest: sha256:c85e21f1f000f0409f58d4ace7aaac0d708f4577a19b638347b41dd37e19f317
13+
sourceBlobDigest: sha256:24159a4c5e03fd9ebc0727cecb2bff5ed6695d519aeb3fe80346af6ce1fabcfa
1414
tags:
1515
- latest
1616
targets:
1717
Java:
1818
source: stacks-source
1919
sourceNamespace: stacks-source
20-
sourceRevisionDigest: sha256:8e24b24261d6d29c5d7c91f8756cb9e47d21d0a8297e6dbe2acf706410a84747
21-
sourceBlobDigest: sha256:d6ef9edab168ce242ff12833d07c2be33b42d4e66fa4159f5a4f12bc5a5543b3
20+
sourceRevisionDigest: sha256:c85e21f1f000f0409f58d4ace7aaac0d708f4577a19b638347b41dd37e19f317
21+
sourceBlobDigest: sha256:24159a4c5e03fd9ebc0727cecb2bff5ed6695d519aeb3fe80346af6ce1fabcfa
2222
codeSamplesNamespace: stacks-source-java-code-samples
23-
codeSamplesRevisionDigest: sha256:8c1607de74390bb4c2d0d25cdeb3ac66c2b0dd38961eb8092f6b22483c4c4340
23+
codeSamplesRevisionDigest: sha256:004d84afe35c23d0605270d93d09d556d180afad2f71e0baede62f6161227e2b
2424
workflow:
2525
workflowVersion: 1.0.0
2626
speakeasyVersion: latest

‎README.md‎

Lines changed: 81 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ and standard method from web, mobile and desktop applications.
3434
* [Available Resources and Operations](#available-resources-and-operations)
3535
* [Error Handling](#error-handling)
3636
* [Authentication](#authentication-1)
37+
* [Server Selection](#server-selection)
3738
* [Custom HTTP Client](#custom-http-client)
3839
* [Debugging](#debugging)
3940
* [Jackson Configuration](#jackson-configuration)
@@ -54,15 +55,15 @@ The samples below show how a published SDK artifact is used:
5455

5556
Gradle:
5657
```groovy
57-
implementation 'com.formance:formance-sdk:9.0.0'
58+
implementation 'com.formance:formance-sdk:9.1.0'
5859
```
5960

6061
Maven:
6162
```xml
6263
<dependency>
6364
<groupId>com.formance</groupId>
6465
<artifactId>formance-sdk</artifactId>
65-
<version>9.0.0</version>
66+
<version>9.1.0</version>
6667
</dependency>
6768
```
6869

@@ -583,6 +584,84 @@ public class Application {
583584
```
584585
<!-- End Authentication [security] -->
585586

587+
<!-- Start Server Selection [server] -->
588+
## Server Selection
589+
590+
### Select Server by Index
591+
592+
You can override the default server globally using the `.serverIndex(int serverIdx)` builder method when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:
593+
594+
| # | Server | Variables | Description |
595+
| --- | ----------------------------------------------------- | -------------------------------- | ------------------------------------------ |
596+
| 0 | `http://localhost` | | local server |
597+
| 1 | `https://{organization}.{environment}.formance.cloud` | `environment`<br/>`organization` | A per-organization and per-environment API |
598+
599+
If the selected server has variables, you may override its default values using the associated builder method(s):
600+
601+
| Variable | BuilderMethod | Supported Values | Default | Description |
602+
| -------------- | -------------------------------------------- | -------------------------------------------------------- | ----------------- | ------------------------------------------------------------- |
603+
| `environment` | `environment(ServerEnvironment environment)` | - `"eu.sandbox"`<br/>- `"eu-west-1"`<br/>- `"us-east-1"` | `"eu.sandbox"` | The environment name. Defaults to the production environment. |
604+
| `organization` | `organization(String organization)` | java.lang.String | `"orgID-stackID"` | The organization name. Defaults to a generic organization. |
605+
606+
#### Example
607+
608+
```java
609+
package hello.world;
610+
611+
import com.formance.formance_sdk.SDK.Builder.ServerEnvironment;
612+
import com.formance.formance_sdk.SDK;
613+
import com.formance.formance_sdk.models.operations.GetVersionsResponse;
614+
import java.lang.Exception;
615+
616+
public class Application {
617+
618+
public static void main(String[] args) throws Exception {
619+
620+
SDK sdk = SDK.builder()
621+
.serverIndex(1)
622+
.environment(ServerEnvironment.US_EAST1)
623+
.organization("<value>")
624+
.build();
625+
626+
GetVersionsResponse res = sdk.getVersions()
627+
.call();
628+
629+
if (res.getVersionsResponse().isPresent()) {
630+
System.out.println(res.getVersionsResponse().get());
631+
}
632+
}
633+
}
634+
```
635+
636+
### Override Server URL Per-Client
637+
638+
The default server can also be overridden globally using the `.serverURL(String serverUrl)` builder method when initializing the SDK client instance. For example:
639+
```java
640+
package hello.world;
641+
642+
import com.formance.formance_sdk.SDK;
643+
import com.formance.formance_sdk.models.operations.GetVersionsResponse;
644+
import java.lang.Exception;
645+
646+
public class Application {
647+
648+
public static void main(String[] args) throws Exception {
649+
650+
SDK sdk = SDK.builder()
651+
.serverURL("https://orgID-stackID.eu.sandbox.formance.cloud")
652+
.build();
653+
654+
GetVersionsResponse res = sdk.getVersions()
655+
.call();
656+
657+
if (res.getVersionsResponse().isPresent()) {
658+
System.out.println(res.getVersionsResponse().get());
659+
}
660+
}
661+
}
662+
```
663+
<!-- End Server Selection [server] -->
664+
586665
<!-- Start Custom HTTP Client [http-client] -->
587666
## Custom HTTP Client
588667

‎RELEASES.md‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -339,4 +339,14 @@ Based on:
339339
### Generated
340340
- [java v9.0.0] .
341341
### Releases
342-
- [Maven Central v9.0.0] https://central.sonatype.com/artifact/com.formance/formance-sdk/9.0.0 - .
342+
- [Maven Central v9.0.0] https://central.sonatype.com/artifact/com.formance/formance-sdk/9.0.0 - .
343+
344+
## 2026-06-01 09:05:01
345+
### Changes
346+
Based on:
347+
- OpenAPI Doc
348+
- Speakeasy CLI 1.768.2 (2.889.1) https://github.com/speakeasy-api/speakeasy
349+
### Generated
350+
- [java v9.1.0] .
351+
### Releases
352+
- [Maven Central v9.1.0] https://central.sonatype.com/artifact/com.formance/formance-sdk/9.1.0 - .

‎docs/models/operations/RunScriptResponse.md‎

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

‎docs/sdks/authv1/README.md‎

Lines changed: 0 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,6 @@ public class Application {
5757
| Parameter | Type | Required | Description |
5858
| ------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
5959
| `request` | [ClientOptions2](../../models/shared/ClientOptions2.md) | :heavy_check_mark: | The request object to use for the request. |
60-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
6160

6261
### Response
6362

@@ -116,7 +115,6 @@ public class Application {
116115
| Parameter | Type | Required | Description |
117116
| --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
118117
| `request` | [CreateSecretRequest](../../models/operations/CreateSecretRequest.md) | :heavy_check_mark: | The request object to use for the request. |
119-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
120118

121119
### Response
122120

@@ -173,7 +171,6 @@ public class Application {
173171
| Parameter | Type | Required | Description |
174172
| --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
175173
| `request` | [DeleteClientRequest](../../models/operations/DeleteClientRequest.md) | :heavy_check_mark: | The request object to use for the request. |
176-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
177174

178175
### Response
179176

@@ -231,7 +228,6 @@ public class Application {
231228
| Parameter | Type | Required | Description |
232229
| --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
233230
| `request` | [DeleteSecretRequest](../../models/operations/DeleteSecretRequest.md) | :heavy_check_mark: | The request object to use for the request. |
234-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
235231

236232
### Response
237233

@@ -277,12 +273,6 @@ public class Application {
277273
}
278274
```
279275

280-
### Parameters
281-
282-
| Parameter | Type | Required | Description |
283-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
284-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
285-
286276
### Response
287277

288278
**[GetOIDCWellKnownsResponse](../../models/operations/GetOIDCWellKnownsResponse.md)**
@@ -329,12 +319,6 @@ public class Application {
329319
}
330320
```
331321

332-
### Parameters
333-
334-
| Parameter | Type | Required | Description |
335-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
336-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
337-
338322
### Response
339323

340324
**[GetServerInfoAuthResponse](../../models/operations/GetServerInfoAuthResponse.md)**
@@ -381,12 +365,6 @@ public class Application {
381365
}
382366
```
383367

384-
### Parameters
385-
386-
| Parameter | Type | Required | Description |
387-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
388-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
389-
390368
### Response
391369

392370
**[ListClientsResponse](../../models/operations/ListClientsResponse.md)**
@@ -433,12 +411,6 @@ public class Application {
433411
}
434412
```
435413

436-
### Parameters
437-
438-
| Parameter | Type | Required | Description |
439-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
440-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
441-
442414
### Response
443415

444416
**[ListUsersResponse](../../models/operations/ListUsersResponse.md)**
@@ -496,7 +468,6 @@ public class Application {
496468
| Parameter | Type | Required | Description |
497469
| ----------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- |
498470
| `request` | [ReadClientRequest](../../models/operations/ReadClientRequest.md) | :heavy_check_mark: | The request object to use for the request. |
499-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
500471

501472
### Response
502473

@@ -555,7 +526,6 @@ public class Application {
555526
| Parameter | Type | Required | Description |
556527
| ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- |
557528
| `request` | [ReadUserRequest](../../models/operations/ReadUserRequest.md) | :heavy_check_mark: | The request object to use for the request. |
558-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
559529

560530
### Response
561531

@@ -614,7 +584,6 @@ public class Application {
614584
| Parameter | Type | Required | Description |
615585
| --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------- |
616586
| `request` | [UpdateClientRequest](../../models/operations/UpdateClientRequest.md) | :heavy_check_mark: | The request object to use for the request. |
617-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
618587

619588
### Response
620589

‎docs/sdks/ledger/README.md‎

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -44,12 +44,6 @@ public class Application {
4444
}
4545
```
4646

47-
### Parameters
48-
49-
| Parameter | Type | Required | Description |
50-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
51-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
52-
5347
### Response
5448

5549
**[V2GetInfoResponse](../../models/operations/V2GetInfoResponse.md)**
@@ -98,12 +92,6 @@ public class Application {
9892
}
9993
```
10094

101-
### Parameters
102-
103-
| Parameter | Type | Required | Description |
104-
| ------------------------------ | ------------------------------ | ------------------------------ | ------------------------------ |
105-
| `serverURL` | *String* | :heavy_minus_sign: | An optional server URL to use. |
106-
10795
### Response
10896

10997
**[GetMetricsResponse](../../models/operations/GetMetricsResponse.md)**

0 commit comments

Comments
 (0)