Java SDK

Installation

Java

 <dependency>
  <groupId>com.workos</groupId>
  <artifactId>workos</artifactId>
  <version>{version}</version>
</dependency>

 dependencies {
  implementation 'com.workos:workos:VERSION'
}

Beta Versions

Certain WorkOS features may be available only in the beta version of the SDK. Beta versions have the -beta.* suffix, for example, 3.2.0-beta.1. For more information on how to use beta versions, refer to the README in the GitHub repository.

Releases

May 26, 2026

v6.0.0

Latest

May 26, 2026

Bug Fixes

deps: update dependency com.nimbusds:nimbus-jose-jwt to v10 (https://github.com/workos/workos-kotlin/issues/384" rel="noreferrer" target="_blank">#384) (https://github.com/workos/workos-kotlin/commit/b866a33c790fdaf91610435dbcd2db588ba07463" rel="noreferrer" target="_blank">b866a33)
deps: update dependency com.squareup.okhttp3:okhttp to v5 (https://github.com/workos/workos-kotlin/issues/385" rel="noreferrer" target="_blank">#385) (https://github.com/workos/workos-kotlin/commit/8d20796f671c33862fc1987eb9ee7f2af490b34a" rel="noreferrer" target="_blank">8d20796)
deps: update dependency org.jetbrains.kotlinx:kotlinx-coroutines-core to v1.11.0 (https://github.com/workos/workos-kotlin/issues/381" rel="noreferrer" target="_blank">#381) (https://github.com/workos/workos-kotlin/commit/09130f004d01b26eb0ef78cc33ac13c4c89439ae" rel="noreferrer" target="_blank">09130f0)

https://github.com/workos/workos-kotlin/pull/388" rel="noreferrer" target="_blank">#388 feat(generated)!: regenerate from spec (13 changes)

⚠️ Breaking

vault: Rewrite Vault service from auto-generated spec
Vault was previously a hand-maintained class; it is now auto-generated and accessible via WorkOS.vault
Renamed methods: listObjects → listKv, createObject → createKv, readObject/readObjectByName → getKv/getName, getObjectMetadata → listKvMetadata, updateObject → updateKv, deleteObject → deleteKv, listObjectVersions → listKvVersions, decryptDataKey → createDecrypt
Added new method: createRekey
Removed types previously defined in Vault.kt: DataKey, DataKeyPair, VaultObject, ObjectDigest, ObjectUpdateBy, ObjectMetadata, ObjectVersion, and KeyContext type alias — replaced by generated models in com.workos.models.*
Client-side encrypt and decrypt helper methods are preserved
user_management: Move organization membership methods to separate service
Removed organization membership methods from UserManagement: listOrganizationMemberships, createOrganizationMembership, getOrganizationMembership, updateOrganizationMembership, deleteOrganizationMembership, deactivateOrganizationMembership, reactivateOrganizationMembership
These methods are now available on the new OrganizationMembershipService as list, create, get, update, delete, deactivate, reactivate
Removed CreateUserRole class from UserManagement (now in OrganizationMembershipService)
Deleted UserManagementOrganizationMembershipGroups class and its package
Updated WorkOS.userManagementOrganizationMembershipGroups to WorkOS.organizationMembership
authorization: Remove search parameter from listResources operations
Removed search parameter from listResources method and related variants
Removed search parameter from listResourcesById, listResourcesByExternalId, and their suspend variants
Added new filter parameters to listRoleAssignments: resourceId, resourceExternalId, resourceTypeSlug
Added new filter parameter to listRoleAssignmentsForResourceByExternalId: roleSlug
Added new filter parameter to listRoleAssignmentsForResource: roleSlug
radar: Remove device fingerprint and bot score parameters from createAttempt
Removed deviceFingerprint parameter from Radar.createAttempt and createAttemptSuspend
Removed botScore parameter from Radar.createAttempt and createAttemptSuspend
Updated RadarStandaloneAssessRequest model to remove device_fingerprint and bot_score fields
radar: Update RadarStandaloneAssessRequestAction enum values
Removed enum values: Login, Signup, SignUp2, SignIn2, SignIn3, SignUp3
Changed SignUp value from 'sign up' to 'sign-up'
Changed SignIn value from 'sign in' to 'sign-in'
radar: Remove enum values from RadarStandaloneResponseControl
Removed CredentialStuffing enum value
Removed IpSignUpRateLimit enum value
audit_logs: Rename AuditLog model classes and update references
Renamed AuditLogActionJson to AuditLogAction
Renamed AuditLogExportJson to AuditLogExport
Renamed AuditLogsRetentionJson to AuditLogsRetention
Deleted AuditLogSchemaJson; its fields (version, createdAt, objectType) were absorbed into AuditLogSchema
Renamed AuditLogSchemaJsonActor to AuditLogSchemaActorInput
Renamed AuditLogSchemaJsonTarget to AuditLogSchemaTargetInput
Added new AuditLogSchemaInput model for create/update operations
Changed AuditLogs.createSchema parameter types from AuditLogSchemaTarget/AuditLogSchemaActor to AuditLogSchemaTargetInput/AuditLogSchemaActorInput
Updated all method return types and parameter types in AuditLogs service
webhooks: Rename WebhookEndpoint model and status enum
Renamed WebhookEndpointJson to WebhookEndpoint
Renamed WebhookEndpointJsonStatus to WebhookEndpointStatus
Updated UpdateWebhookEndpointStatus to alias the renamed status enum
Updated all Webhooks service method signatures and return types
Updated parameter type for status in updateEndpoint method
generated: Rename model classes and type aliases for consistency
Changed ApplicationCredentialsListItem.last_used_at field type from String? to OffsetDateTime?
Changed NewConnectApplicationSecret.last_used_at field type from String? to OffsetDateTime?
Updated FlagRuleUpdatedContextConfiguredTargetOrganization to be an alias for Actor
Updated FlagRuleUpdatedContextPreviousAttributeContextConfiguredTargetOrganization to be an alias for Actor
Changed UserManagementAuthenticationScreenHint to be an alias for RadarStandaloneAssessRequestAction

Features

organization_membership: Add new OrganizationMembershipService with membership and group operations
New service OrganizationMembershipService providing organization membership management
Includes list, create, get, update, delete, deactivate, reactivate operations for memberships
Includes listGroups operation to list groups for a membership
All operations available in blocking and suspend variants
vault: Add WorkOS.vault accessor and new operations
Vault is now accessible via WorkOS.vault (previously not exposed on the WorkOS class)
Key operations: createDataKey, createDecrypt, createRekey
Object operations: listKv, createKv, getName, getKv, updateKv, deleteKv, listKvMetadata, listKvVersions
All operations available in blocking and suspend variants
api_keys: Add expires_at field to API key models and creation methods
Added expires_at field to ApiKey, OrganizationApiKey, OrganizationApiKeyWithValue, UserApiKey, UserApiKeyWithValue models
Added expires_at optional parameter to createOrganizationApiKey method in ApiKeys service
Added expires_at optional parameter to createApiKey method in UserManagement service
Added expires_at field to request models: CreateOrganizationApiKey, CreateUserApiKey
Added expires_at field to event data models: ApiKeyCreatedData, ApiKeyRevokedData
webhooks: Add pipe connected account webhook event types
Added three new webhook event types: PIPES_CONNECTED_ACCOUNT_CONNECTED, PIPES_CONNECTED_ACCOUNT_DISCONNECTED, PIPES_CONNECTED_ACCOUNT_REAUTHORIZATION_NEEDED
Added to both CreateWebhookEndpointEvents and UpdateWebhookEndpointEvents enums
Added corresponding event models: PipesConnectedAccountConnected, PipesConnectedAccountDisconnected, PipesConnectedAccountReauthorizationNeeded
generated: Add new models and enums
New Vault-related models: CreateDataKeyRequest, CreateDataKeyResponse, CreateObjectRequest, DecryptRequest, DecryptResponse, DeleteObjectResponse, RekeyRequest, UpdateObjectRequest
New Vault-related models: Object, ObjectMetadata, ObjectSummary, ObjectVersion, ObjectWithoutValue, VersionListResponse, ListMetadata
New general models: Actor, ErrorResponse
New Connect models: ConnectApplicationM2M, ConnectApplicationOAuth, ConnectApplicationOAuthRedirectUris
New enum: PipeConnectedAccountState
New enum: SortOrder
New event models: PipeConnectedAccount, PipesConnectedAccountConnected, PipesConnectedAccountDisconnected, PipesConnectedAccountReauthorizationNeeded
Updated WorkOSEvent to include new Pipes webhook event types

May 11, 2026

v5.1.0

May 11, 2026

v5.0.0...v5.1.0" rel="noreferrer" target="_blank">5.1.0 (2026-05-11)

Features

publish Dokka API docs to GitHub Pages (https://github.com/workos/workos-kotlin/issues/379" rel="noreferrer" target="_blank">#379) (https://github.com/workos/workos-kotlin/commit/8dbce542d61fbaa7332d6ce7f0cc806ca987be4f" rel="noreferrer" target="_blank">8dbce54)

Bug Fixes

deps: update minor and patch updates (https://github.com/workos/workos-kotlin/issues/358" rel="noreferrer" target="_blank">#358) (https://github.com/workos/workos-kotlin/commit/74a45fff86e1b69fa562d8bea493a8ed6b6d048e" rel="noreferrer" target="_blank">74a45ff)
harden URL/token handling and webhook timestamp validation (https://github.com/workos/workos-kotlin/issues/380" rel="noreferrer" target="_blank">#380) (https://github.com/workos/workos-kotlin/commit/e10f2a3d2a0f20378fb91b1fd2d30a75203317e5" rel="noreferrer" target="_blank">e10f2a3)
mask each line of decoded signing key in release workflow (https://github.com/workos/workos-kotlin/commit/0aa1609c868455af6ca9f561064f7b69bed5c546" rel="noreferrer" target="_blank">0aa1609)

May 6, 2026

v5.0.0

May 6, 2026

⚠ BREAKING CHANGES

Release the next major SDK version (https://github.com/workos/workos-kotlin/issues/357" rel="noreferrer" target="_blank">#357)
Upgrade to Java 17 and migrate any Fuel-based HTTP customization to OkHttpClient
Recreate WorkOS clients with constructor-based configuration instead of mutating apiHostname, https, or port
Update service accessors and method names across the SDK, including renamed services such as PortalApi -> AdminPortal, MfaApi -> MultiFactorAuth, and FgaApi -> Authorization
Replace per-service model, type, and builder imports with the consolidated shared packages and newer flat method arguments or option classes
Adopt the new pagination, webhook verification, and request handling patterns used across v5
Review any existing FGA integrations closely, since the v5 Authorization API is a redesign rather than a direct rename

Features

Release the next major SDK version (https://github.com/workos/workos-kotlin/issues/357" rel="noreferrer" target="_blank">#357) (https://github.com/workos/workos-kotlin/commit/0b2b9e86d63ed011ea7a4888fc14e39bc9326fcb" rel="noreferrer" target="_blank">0b2b9e8)
Regenerate service clients from the OpenAPI spec and standardize retries, pagination, request overrides, and error handling across the SDK
Consolidate generated models and enums into shared packages to reduce service-specific surface area
Move webhook signature verification to the standalone Webhook helper while keeping webhook endpoint management on the Webhooks service

Please read the v5 migration guide before upgrading: https://github.com/workos/workos-kotlin/blob/v5.0.0/docs/V5_MIGRATION_GUIDE.md

Full Changelog: v4.25.0...v5.0.0

May 1, 2026

v4.25.0

May 1, 2026

v4.24.0...v4.25.0" rel="noreferrer" target="_blank">4.25.0 (2026-04-30)

Features

Add external_id to User model (https://github.com/workos/workos-kotlin/issues/371" rel="noreferrer" target="_blank">#371) (https://github.com/workos/workos-kotlin/commit/6355ffc0bad787eab90ee9924699883be09405b5" rel="noreferrer" target="_blank">6355ffc)

April 30, 2026

v4.24.0

April 30, 2026

v4.23.0...v4.24.0" rel="noreferrer" target="_blank">4.24.0 (2026-04-30)

Features

Add user to organization membership response (https://github.com/workos/workos-kotlin/issues/369" rel="noreferrer" target="_blank">#369) (https://github.com/workos/workos-kotlin/commit/de6e1c4f19410afa207aefeec29333db746a3b04" rel="noreferrer" target="_blank">de6e1c4)
Add Authorization (FGA) API endpoints (https://github.com/workos/workos-kotlin/issues/353" rel="noreferrer" target="_blank">#353) (https://github.com/workos/workos-kotlin/commit/23fdabdd3e0af24b69e5c759ae863df77858ebee" rel="noreferrer" target="_blank">23fdabd)
Add custom_attributes field to OrganizationMembership (https://github.com/workos/workos-kotlin/issues/306" rel="noreferrer" target="_blank">#306) (https://github.com/workos/workos-kotlin/commit/7e4643ebb5f0f462ae9e0c9b30206ceca0e9fc29" rel="noreferrer" target="_blank">7e4643e)
Add email field to DirectoryUser (https://github.com/workos/workos-kotlin/issues/321" rel="noreferrer" target="_blank">#321) (https://github.com/workos/workos-kotlin/commit/f6defcb72d498bc564ab0b103b34a62a4cb289a3" rel="noreferrer" target="_blank">f6defcb)
Add missing event models, types, and tests (https://github.com/workos/workos-kotlin/issues/347" rel="noreferrer" target="_blank">#347) (https://github.com/workos/workos-kotlin/commit/9f1ec27f9f4f723a5af34de53d28c90e6311511c" rel="noreferrer" target="_blank">9f1ec27)
add organization_id to OrganizationDomain model (https://github.com/workos/workos-kotlin/issues/350" rel="noreferrer" target="_blank">#350) (https://github.com/workos/workos-kotlin/commit/a261a3efa6773bf3bcc27ebe3234b23b8fee841f" rel="noreferrer" target="_blank">a261a3e)
add release-please for automated releases (https://github.com/workos/workos-kotlin/issues/322" rel="noreferrer" target="_blank">#322) (https://github.com/workos/workos-kotlin/commit/087273f10a4b89bd6261f2f786ae18b2a8d0d53c" rel="noreferrer" target="_blank">087273f)
Add resourceExternalId optional filter param for listAuthorizationResources (https://github.com/workos/workos-kotlin/issues/368" rel="noreferrer" target="_blank">#368) (https://github.com/workos/workos-kotlin/commit/2219cf65024422ee1c7886a3fe6f670c3d81d0fe" rel="noreferrer" target="_blank">2219cf6)
user-management: add directoryManaged to OrganizationMembership (https://github.com/workos/workos-kotlin/issues/336" rel="noreferrer" target="_blank">#336) (https://github.com/workos/workos-kotlin/commit/b0ad0d3f8d7579733c9eea78393317618528037c" rel="noreferrer" target="_blank">b0ad0d3)

Bug Fixes

Add missing portal intents (https://github.com/workos/workos-kotlin/issues/345" rel="noreferrer" target="_blank">#345) (https://github.com/workos/workos-kotlin/commit/912e64d25f98c49b0b3b725e7b2095fb557d9ce3" rel="noreferrer" target="_blank">912e64d)
Add organization domain verification webhook events (https://github.com/workos/workos-kotlin/issues/346" rel="noreferrer" target="_blank">#346) (https://github.com/workos/workos-kotlin/commit/f92ac24dc63b5fe9501e9e58398db5dea98027ef" rel="noreferrer" target="_blank">f92ac24)
Make UserUpdated extend User for dsync.user.updated events (https://github.com/workos/workos-kotlin/issues/334" rel="noreferrer" target="_blank">#334) (https://github.com/workos/workos-kotlin/commit/7b1782f59b4fb0d3d5b58c7740f5c54252acfb01" rel="noreferrer" target="_blank">7b1782f)
remove @JsonCreator from all-default-param classes for Jackson 2.21.x compatibility (https://github.com/workos/workos-kotlin/issues/354" rel="noreferrer" target="_blank">#354) (https://github.com/workos/workos-kotlin/commit/118d1b382ef7a9e5f053f936814ec50c7374d68d" rel="noreferrer" target="_blank">118d1b3)
Remove extractVersion from matchUpdateTypes rules (https://github.com/workos/workos-kotlin/issues/366" rel="noreferrer" target="_blank">#366) (https://github.com/workos/workos-kotlin/commit/581225c304328d5529cf4a42d3ba9a51adec1c38" rel="noreferrer" target="_blank">581225c)
serialize list query params as comma-separated lowercase values (https://github.com/workos/workos-kotlin/issues/355" rel="noreferrer" target="_blank">#355) (https://github.com/workos/workos-kotlin/commit/f62826cf30d0d8863c23f2f1dedc858bde7c81c5" rel="noreferrer" target="_blank">f62826c)
update renovate rules (https://github.com/workos/workos-kotlin/issues/319" rel="noreferrer" target="_blank">#319) (https://github.com/workos/workos-kotlin/commit/740b5fa7a942fa39185c66cc1eafeb8a3ade5fff" rel="noreferrer" target="_blank">740b5fa)
use explicit JsonCreator.Mode.PROPERTIES for Jackson 2.21.0 compatibility (https://github.com/workos/workos-kotlin/issues/348" rel="noreferrer" target="_blank">#348) (https://github.com/workos/workos-kotlin/commit/52aed907ee95a93ea61ba54698aaca153fc03580" rel="noreferrer" target="_blank">52aed90)

April 23, 2026

v4.23.0

April 23, 2026

workos-v4.22.0...workos-v4.23.0" rel="noreferrer" target="_blank">4.23.0 (2026-04-23)

Features

Add resourceExternalId optional filter param for listAuthorizationResources (https://github.com/workos/workos-kotlin/issues/368" rel="noreferrer" target="_blank">#368) (https://github.com/workos/workos-kotlin/commit/2219cf65024422ee1c7886a3fe6f670c3d81d0fe" rel="noreferrer" target="_blank">2219cf6)

Bug Fixes

Remove extractVersion from matchUpdateTypes rules (https://github.com/workos/workos-kotlin/issues/366" rel="noreferrer" target="_blank">#366) (https://github.com/workos/workos-kotlin/commit/581225c304328d5529cf4a42d3ba9a51adec1c38" rel="noreferrer" target="_blank">581225c)

April 8, 2026

workos: v4.22.0

April 8, 2026

workos-v4.21.0...workos-v4.22.0" rel="noreferrer" target="_blank">4.22.0 (2026-04-08)

Features

Add Authorization (FGA) API endpoints (https://github.com/workos/workos-kotlin/issues/353" rel="noreferrer" target="_blank">#353) (https://github.com/workos/workos-kotlin/commit/23fdabdd3e0af24b69e5c759ae863df77858ebee" rel="noreferrer" target="_blank">23fdabd)
add organization_id to OrganizationDomain model (https://github.com/workos/workos-kotlin/issues/350" rel="noreferrer" target="_blank">#350) (https://github.com/workos/workos-kotlin/commit/a261a3efa6773bf3bcc27ebe3234b23b8fee841f" rel="noreferrer" target="_blank">a261a3e)

Bug Fixes

remove @JsonCreator from all-default-param classes for Jackson 2.21.x compatibility (https://github.com/workos/workos-kotlin/issues/354" rel="noreferrer" target="_blank">#354) (https://github.com/workos/workos-kotlin/commit/118d1b382ef7a9e5f053f936814ec50c7374d68d" rel="noreferrer" target="_blank">118d1b3)
serialize list query params as comma-separated lowercase values (https://github.com/workos/workos-kotlin/issues/355" rel="noreferrer" target="_blank">#355) (https://github.com/workos/workos-kotlin/commit/f62826cf30d0d8863c23f2f1dedc858bde7c81c5" rel="noreferrer" target="_blank">f62826c)

March 26, 2026

workos: v4.21.0

March 26, 2026

workos-v4.20.0...workos-v4.21.0" rel="noreferrer" target="_blank">4.21.0 (2026-03-26)

Features

Add missing event models, types, and tests (https://github.com/workos/workos-kotlin/issues/347" rel="noreferrer" target="_blank">#347) (https://github.com/workos/workos-kotlin/commit/9f1ec27f9f4f723a5af34de53d28c90e6311511c" rel="noreferrer" target="_blank">9f1ec27)

Bug Fixes

Add organization domain verification webhook events (https://github.com/workos/workos-kotlin/issues/346" rel="noreferrer" target="_blank">#346) (https://github.com/workos/workos-kotlin/commit/f92ac24dc63b5fe9501e9e58398db5dea98027ef" rel="noreferrer" target="_blank">f92ac24)
use explicit JsonCreator.Mode.PROPERTIES for Jackson 2.21.0 compatibility (https://github.com/workos/workos-kotlin/issues/348" rel="noreferrer" target="_blank">#348) (https://github.com/workos/workos-kotlin/commit/52aed907ee95a93ea61ba54698aaca153fc03580" rel="noreferrer" target="_blank">52aed90)

March 24, 2026

workos: v4.20.0

March 24, 2026

workos-v4.19.1...workos-v4.20.0" rel="noreferrer" target="_blank">4.20.0 (2026-03-24)

Features

user-management: add directoryManaged to OrganizationMembership (https://github.com/workos/workos-kotlin/issues/336" rel="noreferrer" target="_blank">#336) (https://github.com/workos/workos-kotlin/commit/b0ad0d3f8d7579733c9eea78393317618528037c" rel="noreferrer" target="_blank">b0ad0d3)

Bug Fixes

Add missing portal intents (https://github.com/workos/workos-kotlin/issues/345" rel="noreferrer" target="_blank">#345) (https://github.com/workos/workos-kotlin/commit/912e64d25f98c49b0b3b725e7b2095fb557d9ce3" rel="noreferrer" target="_blank">912e64d)

March 4, 2026

workos: v4.19.1

March 4, 2026

workos-v4.19.0...workos-v4.19.1" rel="noreferrer" target="_blank">4.19.1 (2026-03-04)

Bug Fixes

Make UserUpdated extend User for dsync.user.updated events (https://github.com/workos/workos-kotlin/issues/334" rel="noreferrer" target="_blank">#334) (https://github.com/workos/workos-kotlin/commit/7b1782f59b4fb0d3d5b58c7740f5c54252acfb01" rel="noreferrer" target="_blank">7b1782f)

February 26, 2026

workos: v4.19.0

February 26, 2026

workos-v4.18.1...workos-v4.19.0" rel="noreferrer" target="_blank">4.19.0 (2026-02-26)

Features

Add custom_attributes field to OrganizationMembership (https://github.com/workos/workos-kotlin/issues/306" rel="noreferrer" target="_blank">#306) (https://github.com/workos/workos-kotlin/commit/7e4643ebb5f0f462ae9e0c9b30206ceca0e9fc29" rel="noreferrer" target="_blank">7e4643e)
Add email field to DirectoryUser (https://github.com/workos/workos-kotlin/issues/321" rel="noreferrer" target="_blank">#321) (https://github.com/workos/workos-kotlin/commit/f6defcb72d498bc564ab0b103b34a62a4cb289a3" rel="noreferrer" target="_blank">f6defcb)
add release-please for automated releases (https://github.com/workos/workos-kotlin/issues/322" rel="noreferrer" target="_blank">#322) (https://github.com/workos/workos-kotlin/commit/087273f10a4b89bd6261f2f786ae18b2a8d0d53c" rel="noreferrer" target="_blank">087273f)

Bug Fixes

update renovate rules (https://github.com/workos/workos-kotlin/issues/319" rel="noreferrer" target="_blank">#319) (https://github.com/workos/workos-kotlin/commit/740b5fa7a942fa39185c66cc1eafeb8a3ade5fff" rel="noreferrer" target="_blank">740b5fa)

December 3, 2025

v4.18.1

December 3, 2025

What's Changed

Bump version 4.18.1 by @kendallstrautman in #304
Multiple roles support: Add roles property to directory user and SSO profile by @kendallstrautman in #302

Full Changelog: v4.17.0...v4.18.1

December 2, 2025

v4.18.0

December 2, 2025

⚠️ Misconfigured release version. Use v4.18.1 instead

In this version, the package semver was not updated properly and still references v4.17.0

What's Changed

Multiple roles support: Add roles property to directory user and SSO profile by @kendallstrautman in #302

Full Changelog: v4.17.0...v4.18.0

November 21, 2025

v4.17.0

November 21, 2025

What's Changed

Add ability to resend invitation by @antn in #299

New Contributors

@antn made their first contribution in #299

Full Changelog: v4.16.0...v4.17.0

October 10, 2025

v4.16.0

October 10, 2025

What's Changed

Update Nexus publishing endpoints by @nicknisi in #296
Add multiple roles support for OrganizationMemberships by @csrbarber in #295
v4.16.0 by @csrbarber in #297

New Contributors

@csrbarber made their first contribution in #295

Full Changelog: v4.15.0...v4.16.0

September 29, 2025

v4.15.0

September 29, 2025

Added

Added Events API Support (#292)
Added Invitation Accepted, Revoked Events (#291)

Fixed

Fixed OAuth error response mapping for authentication endpoints (#290)

June 23, 2025

v4.14.0

June 23, 2025

What's Changed

Added email to UpdateUserOptions (https://github.com/workos/workos-kotlin/pull/281)
Added user webhook events (https://github.com/workos/workos-kotlin/pull/284)
Added support for custom scopes (https://github.com/workos/workos-kotlin/pull/285)

Full Changelog: v4.13.0...v4.14.0

May 20, 2025

v4.13.0

May 20, 2025

What's Changed

adding "deleting" to connectionState enums by @rarevalo13 in #278
Add warnings to FGA check and query responses by @atainter in #280
Bump to v4.13.0 by @rarevalo13 in #279

New Contributors

@rarevalo13 made their first contribution in #278
@atainter made their first contribution in #280

Full Changelog: v4.12.0...v4.13.0

May 2, 2025

v4.12.0

May 2, 2025

What's Changed

Add customAttributes field to SSO Profile (https://github.com/workos/workos-kotlin/pull/275" rel="noreferrer" target="_blank">#275)

Full Changelog: v4.11.0...v4.12.0" rel="noreferrer" target="_blank">v4.11.0...v4.12.0

April 10, 2025

v4.11.0

April 10, 2025

What's Changed

Added password_reset.succeeded event type (https://github.com/workos/workos-kotlin/pull/273)

Full Changelog: v4.10.0...v4.11.0

March 28, 2025

v4.10.0

March 28, 2025

What's Changed

Add email standard attribute to DirectoryUser (https://github.com/workos/workos-kotlin/pull/270" rel="noreferrer" target="_blank">#270)
Mark emails, job_title, and username standard attributes as deprecated. Enable the equivalent auto-mapped custom attributes instead (https://github.com/workos/workos-kotlin/pull/270" rel="noreferrer" target="_blank">#270)

Full Changelog: v4.9.0...v4.10.0

February 21, 2025

v4.9.0

February 21, 2025

What's Changed

Added state, verificationStrategy, and verificationToken to OrganizationDomain (https://github.com/workos/workos-kotlin/pull/266)
Added lastSignInAt to User (https://github.com/workos/workos-kotlin/pull/268)

Full Changelog: v4.8.0...v4.9.0

January 15, 2025

v4.8.0

January 15, 2025

Added

Added optional returnTo parameter to getLogoutUrl (https://github.com/workos/workos-kotlin/pull/264" rel="noreferrer" target="_blank">#264)

Full Changelog: v4.7.0...v4.8.0

January 6, 2025

v4.7.0

January 6, 2025

Added

Add GET /organization/:orgId/roles API support (https://github.com/workos/workos-kotlin/pull/262" rel="noreferrer" target="_blank">#262)

Full Changelog: v4.6.1...v4.7.0

December 11, 2024

v4.6.1

December 11, 2024

Fixed

Make role attribute optional on directorysync.models.User by @jonatascastro12 in #259

Full Changelog: v4.6.0...v4.6.1

November 15, 2024

v4.6.0

November 15, 2024

Added

Add widgets get token API support (https://github.com/workos/workos-kotlin/pull/257" rel="noreferrer" target="_blank">#257)

Full Changelog: v4.5.0...v4.6.0

October 21, 2024

v4.5.0

October 21, 2024

What's Changed

Add role to directory user by @kendallstrautman in #254

Full Changelog: v4.4.0...v4.5.0

October 17, 2024

v4.4.0

October 17, 2024

What's Changed

Add ProfileRole property in #252

Full Changelog: v4.3.1...v4.4.0

September 13, 2024

v4.3.1

September 13, 2024

Fixed

Fixed FGA query method to make correct requests #250

August 26, 2024

v4.3.0

August 26, 2024

Added

Added support for authentication.sso_failed and authentication.oauth_failed events (https://github.com/workos/workos-kotlin/pull/248" rel="noreferrer" target="_blank">#248)