Skip to content

Commit 19fdafa

Browse files
committed
## Java SDK Changes:
* `clerk.betaFeatures.updateInstanceSettings()`: * `request.enhancedEmailDeliverability` **Removed** **Breaking** ⚠️ * `clerk.instanceSettings.update()`: * `request.enhancedEmailDeliverability` **Removed** **Breaking** ⚠️ * `clerk.organizationPermissions.delete()`: **Added** * `clerk.organizations.update()`: `response.last_active_at` **Added** * `clerk.organizationRoles.delete()`: **Added** * `clerk.organizationRoles.assignPermission()`: **Added** * `clerk.organizationRoles.removePermission()`: **Added** * `clerk.billing.listPlans()`: **Added** * `clerk.billing.listSubscriptionItems()`: **Added** * `clerk.users.deleteProfileImage()`: `response` **Changed** * `clerk.organizationPermissions.list()`: **Added** * `clerk.organizationPermissions.create()`: **Added** * `clerk.organizationPermissions.get()`: **Added** * `clerk.organizationPermissions.update()`: **Added** * `clerk.organizationRoles.list()`: **Added** * `clerk.commerce.listPlans()`: **Deleted** **Breaking** ⚠️ * `clerk.commerce.listSubscriptionItems()`: **Deleted** **Breaking** ⚠️ * `clerk.commerce.cancelSubscriptionItem()`: **Deleted** **Breaking** ⚠️ * `clerk.sessions.create()`: * `request.activeOrganizationId` **Added** * `clerk.users.list()`: `response.[]` **Changed** * `clerk.users.create()`: `response` **Changed** * `clerk.users.get()`: `response` **Changed** * `clerk.users.update()`: `response` **Changed** * `clerk.users.ban()`: `response` **Changed** * `clerk.users.unban()`: `response` **Changed** * `clerk.users.bulkBan()`: `response.[]` **Changed** * `clerk.users.bulkUnban()`: `response.[]` **Changed** * `clerk.users.lock()`: `response` **Changed** * `clerk.organizationRoles.update()`: **Added** * `clerk.users.unlock()`: `response` **Changed** * `clerk.billing.cancelSubscriptionItem()`: **Added** * `clerk.users.updateMetadata()`: `response` **Changed** * `clerk.users.getOrganizationMemberships()`: `response.data.[].organization.lastActiveAt` **Added** * `clerk.users.getOrganizationInvitations()`: `response.data.[].inviterId` **Added** * `clerk.users.getInstanceOrganizationMemberships()`: `response.data.[].organization.lastActiveAt` **Added** * `clerk.organizationInvitations.getAll()`: `response.data.[].inviterId` **Added** * `clerk.organizationInvitations.create()`: `response.inviter_id` **Added** * `clerk.organizationInvitations.list()`: `response.data.[].inviterId` **Added** * `clerk.organizationInvitations.bulkCreate()`: `response.data.[].inviterId` **Added** * `clerk.organizationInvitations.listPending()`: `response.data.[].inviterId` **Added** * `clerk.organizationInvitations.get()`: `response.inviter_id` **Added** * `clerk.organizationInvitations.revoke()`: `response.inviter_id` **Added** * `clerk.organizationRoles.get()`: **Added** * `clerk.organizationRoles.create()`: **Added** * `clerk.instanceSettings.updateOrganizationSettings()`: `response.max_role_sets_allowed` **Added** * `clerk.organizations.list()`: `response.data.[].lastActiveAt` **Added** * `clerk.organizations.create()`: `response.last_active_at` **Added** * `clerk.organizations.get()`: `response.last_active_at` **Added** * `clerk.users.setProfileImage()`: `response` **Changed** * `clerk.organizations.mergeMetadata()`: `response.last_active_at` **Added** * `clerk.organizations.uploadLogo()`: `response.last_active_at` **Added** * `clerk.organizations.deleteLogo()`: `response.last_active_at` **Added** * `clerk.organizationMemberships.create()`: `response.organization.lastActiveAt` **Added** * `clerk.organizationMemberships.list()`: `response.data.[].organization.lastActiveAt` **Added** * `clerk.organizationMemberships.update()`: `response.organization.lastActiveAt` **Added** * `clerk.organizationMemberships.delete()`: `response.organization.lastActiveAt` **Added** * `clerk.organizationMemberships.updateMetadata()`: `response.organization.lastActiveAt` **Added**
1 parent 82881f0 commit 19fdafa

File tree

197 files changed

+18711
-758
lines changed

Some content is hidden

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

197 files changed

+18711
-758
lines changed

.speakeasy/gen.lock

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

.speakeasy/gen.yaml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ generation:
2525
generateNewTests: false
2626
skipResponseBodyAssertions: false
2727
java:
28-
version: 4.0.0
28+
version: 4.1.0
2929
additionalDependencies: []
3030
additionalPlugins: []
3131
artifactID: backend-api
@@ -36,8 +36,8 @@ java:
3636
companyURL: www.mycompany.com
3737
defaultErrorName: SDKError
3838
enableCustomCodeRegions: false
39+
enableSlf4jLogging: false
3940
enableStreamingUploads: false
40-
enhancedUnionMemberResolution: true
4141
flattenGlobalSecurity: true
4242
generateOptionalUnionAccessors: false
4343
generateSpringBootStarter: true
@@ -51,15 +51,19 @@ java:
5151
operations: models/operations
5252
shared: models/components
5353
webhooks: models/webhooks
54+
inferUnionDiscriminators: false
5455
inputModelSuffix: input
5556
languageVersion: 11
5657
license:
5758
name: The MIT License (MIT)
5859
shortName: MIT
5960
url: https://mit-license.org/
6061
maxMethodParams: 4
62+
multipartArrayFormat: legacy
6163
nullFriendlyParameters: false
6264
openUnions: true
65+
operationScopedParams: true
6366
outputModelSuffix: output
6467
projectName: api
6568
templateVersion: v2
69+
unionStrategy: populated-fields

.speakeasy/workflow.lock

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
speakeasyVersion: 1.653.0
1+
speakeasyVersion: 1.665.0
22
sources:
33
clerk-java-sdk:
44
sourceNamespace: clerk-java-sdk
5-
sourceRevisionDigest: sha256:4cdfbca5fe446f5440ef5a91053cdec7dd86d4b1c296a30cec61e1f46e1c3bf0
6-
sourceBlobDigest: sha256:667192662fbf3ee62bd9f4d3e67323b7b6777054d7d08b383e2db721e2911354
5+
sourceRevisionDigest: sha256:e049605104f8420705eeb95805e1598bb4c6c9b8452c26dd11e0b5fec460505a
6+
sourceBlobDigest: sha256:3bef08a77b6f96bde3202eea57e59365d8064a479eaee1bf86c25f953cf74690
77
tags:
88
- latest
9-
- speakeasy-sdk-regen-1756771797
9+
- speakeasy-sdk-regen-1762906246
1010
- "2025-11-10"
1111
targets:
1212
clerk-java:
1313
source: clerk-java-sdk
1414
sourceNamespace: clerk-java-sdk
15-
sourceRevisionDigest: sha256:4cdfbca5fe446f5440ef5a91053cdec7dd86d4b1c296a30cec61e1f46e1c3bf0
16-
sourceBlobDigest: sha256:667192662fbf3ee62bd9f4d3e67323b7b6777054d7d08b383e2db721e2911354
15+
sourceRevisionDigest: sha256:e049605104f8420705eeb95805e1598bb4c6c9b8452c26dd11e0b5fec460505a
16+
sourceBlobDigest: sha256:3bef08a77b6f96bde3202eea57e59365d8064a479eaee1bf86c25f953cf74690
1717
codeSamplesNamespace: clerk-java-sdk-code-samples
18-
codeSamplesRevisionDigest: sha256:ec10b689b7835ba5566ba1569f14e7b197a7dcba7dd11c0753c62de6d3f072c4
18+
codeSamplesRevisionDigest: sha256:db82e151c50c92efaa43d5b348b3c786549c46b056ded4239973bf48af45d5b9
1919
my-first-target:
2020
source: clerk-java-sdk
2121
sourceNamespace: clerk-java-sdk

README.md

Lines changed: 38 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -52,15 +52,15 @@ The samples below show how a published SDK artifact is used:
5252

5353
Gradle:
5454
```groovy
55-
implementation 'com.clerk:backend-api:4.0.0'
55+
implementation 'com.clerk:backend-api:4.1.0'
5656
```
5757

5858
Maven:
5959
```xml
6060
<dependency>
6161
<groupId>com.clerk</groupId>
6262
<artifactId>backend-api</artifactId>
63-
<version>4.0.0</version>
63+
<version>4.1.0</version>
6464
</dependency>
6565
```
6666

@@ -219,6 +219,9 @@ public class MachineAuthentication {
219219

220220
### [billing()](docs/sdks/billing/README.md)
221221

222+
* [listPlans](docs/sdks/billing/README.md#listplans) - List all billing plans
223+
* [listSubscriptionItems](docs/sdks/billing/README.md#listsubscriptionitems) - List all subscription items
224+
* [cancelSubscriptionItem](docs/sdks/billing/README.md#cancelsubscriptionitem) - Cancel a subscription item
222225
* [extendSubscriptionItemFreeTrial](docs/sdks/billing/README.md#extendsubscriptionitemfreetrial) - Extend free trial for a subscription item
223226
* [listStatements](docs/sdks/billing/README.md#liststatements) - List all billing statements
224227
* [getStatement](docs/sdks/billing/README.md#getstatement) - Retrieve a billing statement
@@ -236,12 +239,6 @@ public class MachineAuthentication {
236239
* [verify](docs/sdks/clients/README.md#verify) - Verify a client
237240
* [get](docs/sdks/clients/README.md#get) - Get a client
238241

239-
### [commerce()](docs/sdks/commerce/README.md)
240-
241-
* [listPlans](docs/sdks/commerce/README.md#listplans) - List all commerce plans
242-
* [listSubscriptionItems](docs/sdks/commerce/README.md#listsubscriptionitems) - List all subscription items
243-
* [cancelSubscriptionItem](docs/sdks/commerce/README.md#cancelsubscriptionitem) - Cancel a subscription item
244-
245242
### [domains()](docs/sdks/domains/README.md)
246243

247244
* [list](docs/sdks/domains/README.md#list) - List all instance domains
@@ -356,6 +353,24 @@ public class MachineAuthentication {
356353
* [delete](docs/sdks/organizationmemberships/README.md#delete) - Remove a member from an organization
357354
* [updateMetadata](docs/sdks/organizationmemberships/README.md#updatemetadata) - Merge and update organization membership metadata
358355

356+
### [organizationPermissions()](docs/sdks/organizationpermissions/README.md)
357+
358+
* [list](docs/sdks/organizationpermissions/README.md#list) - Get a list of all organization permissions
359+
* [create](docs/sdks/organizationpermissions/README.md#create) - Create a new organization permission
360+
* [get](docs/sdks/organizationpermissions/README.md#get) - Get an organization permission
361+
* [update](docs/sdks/organizationpermissions/README.md#update) - Update an organization permission
362+
* [delete](docs/sdks/organizationpermissions/README.md#delete) - Delete an organization permission
363+
364+
### [organizationRoles()](docs/sdks/organizationroles/README.md)
365+
366+
* [list](docs/sdks/organizationroles/README.md#list) - Get a list of organization roles
367+
* [create](docs/sdks/organizationroles/README.md#create) - Create an organization role
368+
* [get](docs/sdks/organizationroles/README.md#get) - Retrieve an organization role
369+
* [update](docs/sdks/organizationroles/README.md#update) - Update an organization role
370+
* [delete](docs/sdks/organizationroles/README.md#delete) - Delete an organization role
371+
* [assignPermission](docs/sdks/organizationroles/README.md#assignpermission) - Assign a permission to an organization role
372+
* [removePermission](docs/sdks/organizationroles/README.md#removepermission) - Remove a permission from an organization role
373+
359374
### [organizations()](docs/sdks/organizations/README.md)
360375

361376
* [list](docs/sdks/organizations/README.md#list) - Get a list of organizations for an instance
@@ -643,17 +658,17 @@ public class Application {
643658
many more subclasses in the JDK platform).
644659

645660
**Inherit from [`ClerkError`](./src/main/java/models/errors/ClerkError.java)**:
646-
* [`com.clerk.backend_api.models.errors.CreateM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.CreateM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 158 methods.*
647-
* [`com.clerk.backend_api.models.errors.GetM2MTokensResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 158 methods.*
648-
* [`com.clerk.backend_api.models.errors.RevokeM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.RevokeM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 158 methods.*
649-
* [`com.clerk.backend_api.models.errors.VerifyM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 158 methods.*
650-
* [`com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 158 methods.*
651-
* [`com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseBody.java): 403 Forbidden. Status code `403`. Applicable to 1 of 158 methods.*
652-
* [`com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 158 methods.*
653-
* [`com.clerk.backend_api.models.errors.RevokeM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.RevokeM2MTokenM2mResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 158 methods.*
654-
* [`com.clerk.backend_api.models.errors.VerifyM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyM2MTokenM2mResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 158 methods.*
655-
* [`com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenOauthAccessTokensResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenOauthAccessTokensResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 158 methods.*
656-
* [`com.clerk.backend_api.models.errors.CreateM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.CreateM2MTokenM2mResponseBody.java): 409 Conflict. Status code `409`. Applicable to 1 of 158 methods.*
661+
* [`com.clerk.backend_api.models.errors.CreateM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.CreateM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 170 methods.*
662+
* [`com.clerk.backend_api.models.errors.GetM2MTokensResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 170 methods.*
663+
* [`com.clerk.backend_api.models.errors.RevokeM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.RevokeM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 170 methods.*
664+
* [`com.clerk.backend_api.models.errors.VerifyM2MTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyM2MTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 170 methods.*
665+
* [`com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenResponseBody.java): 400 Bad Request. Status code `400`. Applicable to 1 of 170 methods.*
666+
* [`com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseBody.java): 403 Forbidden. Status code `403`. Applicable to 1 of 170 methods.*
667+
* [`com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.GetM2MTokensM2mResponseResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 170 methods.*
668+
* [`com.clerk.backend_api.models.errors.RevokeM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.RevokeM2MTokenM2mResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 170 methods.*
669+
* [`com.clerk.backend_api.models.errors.VerifyM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyM2MTokenM2mResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 170 methods.*
670+
* [`com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenOauthAccessTokensResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.VerifyOAuthAccessTokenOauthAccessTokensResponseBody.java): 404 Not Found. Status code `404`. Applicable to 1 of 170 methods.*
671+
* [`com.clerk.backend_api.models.errors.CreateM2MTokenM2mResponseBody`](./src/main/java/models/errors/com.clerk.backend_api.models.errors.CreateM2MTokenM2mResponseBody.java): 409 Conflict. Status code `409`. Applicable to 1 of 170 methods.*
657672

658673

659674
</details>
@@ -821,9 +836,11 @@ public class Application {
821836
## Debugging
822837

823838
### Debug
839+
824840
You can setup your SDK to emit debug logs for SDK requests and responses.
825841

826842
For request and response logging (especially json bodies), call `enableHTTPDebugLogging(boolean)` on the SDK builder like so:
843+
827844
```java
828845
SDK.builder()
829846
.enableHTTPDebugLogging(true)
@@ -841,10 +858,11 @@ Response body:
841858
"token": "global"
842859
}
843860
```
844-
__WARNING__: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
861+
__WARNING__: This logging should only be used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
845862

846863
__NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging()`. The `SpeakeasyHTTPClient` honors this setting. If you are using a custom HTTP client, it is up to the custom client to honor this setting.
847864

865+
848866
Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
849867
<!-- End Debugging [debug] -->
850868

RELEASES.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -358,4 +358,14 @@ Based on:
358358
### Generated
359359
- [java v4.0.0] .
360360
### Releases
361-
- [Maven Central v4.0.0] https://central.sonatype.com/artifact/com.clerk/backend-api/4.0.0 - .
361+
- [Maven Central v4.0.0] https://central.sonatype.com/artifact/com.clerk/backend-api/4.0.0 - .
362+
363+
## 2025-11-29 00:09:55
364+
### Changes
365+
Based on:
366+
- OpenAPI Doc
367+
- Speakeasy CLI 1.665.0 (2.767.2) https://github.com/speakeasy-api/speakeasy
368+
### Generated
369+
- [java v4.1.0] .
370+
### Releases
371+
- [Maven Central v4.1.0] https://central.sonatype.com/artifact/com.clerk/backend-api/4.1.0 - .
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# ClerkErrorErrorEnterpriseAccountMeta
2+
3+
4+
## Fields
5+
6+
| Field | Type | Required | Description |
7+
| ----------- | ----------- | ----------- | ----------- |
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# ClerkErrorErrorEnterpriseAccountVerificationMeta
2+
3+
4+
## Fields
5+
6+
| Field | Type | Required | Description |
7+
| ----------- | ----------- | ----------- | ----------- |

0 commit comments

Comments
 (0)