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
June 17, 2026
v5.2.0
Latest June 17, 2026
- #268 feat(generated)!: regenerate from spec (12 changes)
⚠️ Breaking
- organization_membership:
- Changed response of
UserManagementOrganizationMembership.listfromUserOrganizationMembershiptoUserOrganizationMembershipList - pipes:
- SDK surface change: Type changed for "DataIntegrationAccessTokenResponseAccessToken.ExpiresAt" from "string?" to "DateTimeOffset?"
- user_management:
- Changed response of
UserManagementInvitations.listfromUserInvitetoUserInviteList - widgets:
- SDK surface change: Symbol "WidgetSessionTokenResponse" was removed
Features
- authorization:
- Added model
ReplaceGroupRoleAssignmentEntry - Added model
ReplaceGroupRoleAssignments - Added model
DeleteGroupRoleAssignmentsByCriteria - Added endpoint
POST /authorization/groups/{group_id}/role_assignments - Added endpoint
PUT /authorization/groups/{group_id}/role_assignments - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments - Added endpoint
GET /authorization/groups/{group_id}/role_assignments/{role_assignment_id} - Added endpoint
DELETE /authorization/groups/{group_id}/role_assignments/{role_assignment_id} - client:
- Added model
ClientApiToken - Added model
ClientApiTokenResponse - Added service
Client - connect:
- Added
auth_methodtoConnectedAccount - Added
api_key_last_4toConnectedAccount - Added enum
ConnectedAccountAuthMethod - groups:
- Added model
CreateGroupRoleAssignment - Added model
GroupRoleAssignment - Added model
GroupRoleAssignmentList - Added model
GroupRoleAssignmentResource - organization_membership:
- Added model
UserOrganizationMembershipList - Added model
UserOrganizationMembershipListListMetadata - pipes:
- Added model
DataIntegrationCredentials - Added model
DataIntegrationConfigurationResponse - Added model
DataIntegrationConfigurationListResponse - Added model
ConfigureDataIntegrationBody - Added
auth_methodstoDataIntegrationsListResponseData - Added
auth_methodtoDataIntegrationsListResponseDataConnectedAccount - Added
api_key_last_4toDataIntegrationsListResponseDataConnectedAccount - Added enum
DataIntegrationCredentialsCredentialsType - Added enum
DataIntegrationsListResponseDataAuthMethods - Added enum
DataIntegrationsListResponseDataConnectedAccountAuthMethod - Added service
PipesProvider - user_management:
- Added model
UserInviteList - Added model
UserInviteListListMetadata - Made
AuthorizationCodeSessionAuthenticateRequest.client_secretoptional - Made
RefreshTokenSessionAuthenticateRequest.client_secretoptional - widgets:
- Added
widgets:pipes:managetoWidgetSessionTokenScopes
June 16, 2026
v5.1.0
June 16, 2026
Bug Fixes
- renovate: explicitly enable minor and patch updates (#261) (a8dd75f)
- use raw JWKS retriever instead of OIDC discovery retriever (#267) (03c3b3d)
- #263 feat(generated): regenerate from spec (9 changes)
Features
- api_keys:
- Added model
ExpireApiKey - Added model
ApiKeyUpdated - Added model
ApiKeyUpdatedData - Added model
ApiKeyUpdatedDataOwner - Added model
UserApiKeyUpdatedDataOwner - Added model
ApiKeyUpdatedDataPreviousAttribute - Added endpoint
POST /api_keys/{id}/expire - audit_logs:
- Added
SnowflaketoAuditLogConfigurationLogStreamType - connect:
- Added
nametoUserObject - directory_sync:
- Added model
DsyncTokenCreated - Added model
DsyncTokenCreatedData - Added model
DsyncTokenRevoked - Added model
DsyncTokenRevokedData - user_management:
- Added
nameto user management models - webhooks:
- Added
api_key.updatedtoCreateWebhookEndpointEvents - Added
api_key.updatedtoUpdateWebhookEndpointEvents
May 26, 2026
v5.0.0
May 26, 2026
5.0.0 (2026-05-26)
⚠ BREAKING CHANGES
- application_credentials: Change LastUsedAt type from string to DateTimeOffset (#259)
- organization_membership: Relocate organization membership operations to dedicated service (#259)
- radar: Remove device_fingerprint and bot_score from Radar assessment (#259)
- user_management: Change ScreenHint type from custom enum to RadarStandaloneAssessRequestAction (#259)
- api_keys: Add expires_at field to API key models (#259)
Features
- api_keys: Add expires_at field to API key models (#259) (eb608f5)
- application_credentials: Change LastUsedAt type from string to DateTimeOffset (#259) (eb608f5)
- organization_membership: Relocate organization membership operations to dedicated service (#259) (eb608f5)
- radar: Remove device_fingerprint and bot_score from Radar assessment (#259) (eb608f5)
- user_management: Change ScreenHint type from custom enum to RadarStandaloneAssessRequestAction (#259) (eb608f5)
- vault: Add new Vault service for encrypted object and key management (#259) (eb608f5)
- webhooks: Add pipes connected account events to webhook endpoint events (#259) (eb608f5)
Bug Fixes
May 11, 2026
v4.0.1
May 11, 2026
May 6, 2026
v4.0.0
May 6, 2026
4.0.0 (2026-05-06)
⚠ BREAKING CHANGES
- user_management: add user API key management and update models
- api_keys: refactor API key models for organization and user ownership
- authorization: replace RoleAssignment with UserRoleAssignment
Features
- api_keys: refactor API key models for organization and user ownership (b6f8e6e)
- authorization: replace RoleAssignment with UserRoleAssignment (b6f8e6e)
- docs: add DocFX-based API reference site (#251) (e19ff24)
- events: add admin_portal event actor source (b6f8e6e)
- user_management: add user API key management and update models (b6f8e6e)
- vault: add BYOK key deleted event and consolidate key provider enum (b6f8e6e)
April 28, 2026
v3.1.0
April 28, 2026
April 24, 2026
v3.0.2
April 24, 2026
April 20, 2026
v3.0.0
April 20, 2026
March 30, 2026
v2.12.0
March 30, 2026
March 5, 2026
v2.11.0
March 5, 2026
December 3, 2025
v2.10.1
December 3, 2025
What's Changed
- Version bump v2.10.1 by @kendallstrautman in #198
- Multiple roles support: Add
rolesproperty to directory user and SSO profile by @kendallstrautman in #197
Full Changelog: v2.9.0...v2.10.1
December 2, 2025
v2.10.0
December 2, 2025
⚠️ Misconfigured release version. Use v2.10.1 instead
In this version, the package semver was not updated properly and still references v2.9.0
What's Changed
- Multiple roles support: Add
rolesproperty to directory user and SSO profile by @kendallstrautman in #197
Full Changelog: v2.9.0...v2.10.0
April 25, 2025
v2.9.0
April 25, 2025
What's Changed
- Update DirectoryUser#PrimaryEmail implementation to allow for testing without obsolete fields (#194)
- Add customAttributes field to SSO Profile (#192)
Full Changelog: v2.8.0...v2.9.0
March 28, 2025
v2.8.0
March 28, 2025
What's Changed
- Add
emailstandard attribute toDirectoryUser(#189) - Mark
emails,job_title, andusernamestandard attributes as deprecated. Enable the equivalent auto-mapped custom attributes instead (#189)
Full Changelog: v2.7.0...v2.8.0
February 24, 2025
v2.7.0
February 24, 2025
December 27, 2024
v2.6.0
December 27, 2024
October 21, 2024
v2.5.0
October 21, 2024
September 23, 2024
v2.4.0
September 23, 2024
What's Changed
- Added custom exceptions for webhook verification by @gcsuk in #177
New Contributors
- @gcsuk made their first contribution in #177
Full Changelog: v2.3.0...v2.4.0
July 18, 2024
v2.3.0
July 18, 2024
What's Changed
- Add AppleOAuth constants by @gcarvelli in #167
- Fix CI badge + add NuGet one by @gcarvelli in #172
- v2.3.0 by @gcarvelli in #170
- Added missing values to DirectoryState enum by @WillyPain in #174
New Contributors
Full Changelog: v2.2.0...v2.3.0
June 26, 2024
v2.2.0
June 26, 2024
Deprecated
- Marked the
AllowProfilesOutsideOrganizationoption as deprecated (#168)
May 8, 2024
v2.1.0
May 8, 2024
What's Changed
- Add
DomainDatato Organization create and update methods, replacing deprecateddomains(#165)
December 14, 2023
v2.0.0
December 14, 2023
Added
- Added ActorIds and ActorNames to CreateAuditLogExportOptions #127
Changed
- [Breaking change] Renamed User to DirectoryUser (#132)
- [Breaking change] Renamed ConnectionType to Type (#138)
- [Breaking change] Changed directory states from linked/unlinked to active/inactive (#142)
- [Breaking change] Changed default list pagination order to be DESC (#159)
- [Breaking change] Changed Connection.Type to be a string and add ProviderType (#154)
Removed
- [Breaking change] Removed Connection Status (#137)
Full Changelog: v1.17.4...v2.0.0
May 25, 2023
v1.17.4
May 25, 2023
March 29, 2023
v1.17.3
March 29, 2023
What's Changed
- Fix user enums to include "Inactive"
March 27, 2023
v1.17.2
March 27, 2023
March 7, 2023
v1.17.0
March 7, 2023
Added
- Added groups attribute to SSO user profile. This feature is in beta, please reach out to [support@workos.com](mailto:support@workos.com) to access this feature. (#117)
December 6, 2022
v1.16.0
December 6, 2022
Added
- Add
log_streamsAdmin Portal intent (https://github.com/workos/workos-dotnet/pull/114)
December 2, 2022
v1.15.2
December 2, 2022
Changed
- Added missing properties
userandissuertototpentity (#111 )
December 2, 2022
v1.15.1
December 2, 2022
Changed
DeleteConnectionnow returns a Task (#110 )