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 23, 2026
v2.2.0
Latest June 23, 2026
- https://github.com/workos/workos-rust/pull/111" rel="noreferrer" target="_blank">#111 feat(generated)!: regenerate from spec (11 changes)
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
Fixes
- organization_membership:
- Changed response of
UserManagementOrganizationMembership.listfromUserOrganizationMembershiptoUserOrganizationMembershipList - user_management:
- Changed response of
UserManagementInvitations.listfromUserInvitetoUserInviteList
June 17, 2026
v2.1.0
June 17, 2026
- https://github.com/workos/workos-rust/pull/105" rel="noreferrer" target="_blank">#105 feat(generated)!: regenerate from spec (10 changes)
⚠️ Breaking
- api_keys:
- Made
expires_atrequired in API key models - directory_sync:
- Removed model
DsyncDeactivated - Removed model
DsyncDeactivatedData - Removed model
DsyncDeactivatedDataDomain - Removed enum
DsyncDeactivatedDataType - Removed enum
DsyncDeactivatedDataState - radar:
- Removed
domain_sign_up_rate_limitfromRadarStandaloneResponseControl - user_management:
- Removed
return_tofromRevokeSession
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 28, 2026
v2.0.1
May 28, 2026
Bug Fixes
- renovate: explicitly enable minor and patch updates (https://github.com/workos/workos-rust/issues/99" rel="noreferrer" target="_blank">#99) (https://github.com/workos/workos-rust/commit/2639af6f0749120a134dd292ef40af3df09e7fd6" rel="noreferrer" target="_blank">2639af6)
- sdk: omit defaulted screen_hint from auth URLs (https://github.com/workos/workos-rust/issues/102" rel="noreferrer" target="_blank">#102) (https://github.com/workos/workos-rust/commit/2dc6fa4a3bfc17a5ef399c6683c406f839f5083b" rel="noreferrer" target="_blank">2dc6fa4)
May 26, 2026
v2.0.0
May 26, 2026
- https://github.com/workos/workos-rust/pull/97" rel="noreferrer" target="_blank">#97 feat(generated)!: regenerate from spec (8 changes)
⚠️ Breaking
- organization_membership: Split organization membership operations from user_management into dedicated service
- New
OrganizationMembershipApiservice with full CRUD and role management for organization memberships - Moved from
UserManagementApi: list/create/get/update/delete/deactivate/reactivate operations - Breaking change: symbols removed from
user_managementand moved toorganization_membership(see compat_breaking list) Roleenum (Single/Multiplevariants) moved fromuser_managementtoorganization_membershipclient.user_management_organization_membership_groups()removed; useclient.organization_membership().list_organization_membership_groups()instead- Group membership listing now accessible via
organization_membership.list_organization_membership_groups - radar: Remove deprecated action and control fields from Radar standalone assessment
- Removed deprecated enum variants:
RadarStandaloneAssessRequestAction::Login,RadarStandaloneAssessRequestAction::Signup,RadarStandaloneResponseControl::CredentialStuffing,RadarStandaloneResponseControl::IpSignUpRateLimit - Removed lenient parsing aliases for
SignUp("sign up","sign_up") andSignIn("sign in","sign_in"); only canonical wire values"sign-up"and"sign-in"are accepted - Removed fields from
RadarStandaloneAssessRequest:device_fingerprintandbot_score(marked breaking in spec) - vault: Replaced hand-written
helpers::VaultApiwith generatedresources::VaultApi client.vault()now returnsresources::VaultApiinstead ofhelpers::VaultApi- Old custom types removed:
DataKeyPair,DataKey,KeyContext,ObjectMetadata,VaultObject,VaultObjectDigest,VaultObjectVersion,VaultListObjectsParams,VaultListObjectsResponse,VaultCreateDataKeyParams,VaultCreateObjectParams,VaultUpdateObjectParams,VaultDecryptDataKeyParams - Replaced by generated types:
CreateDataKeyRequest,CreateDataKeyResponse,DecryptRequest,DecryptResponse,RekeyRequest,CreateObjectRequest,UpdateObjectRequest,VaultObject,ObjectMetadata,ObjectSummary,ObjectVersion,ObjectListResponse,VersionListResponse - Local
encrypt/decryptconvenience methods preserved onresources::VaultApiwith the same behavior - Crypto helpers moved from
helpers::vaulttohelpers::vault_crypto(re-exported:VaultEncryptResult,local_encrypt,local_decrypt,extract_encrypted_keys) - generated: Rename types to remove
Jsonsuffix and standardize naming AuditLogExportJsonState→AuditLogExportStateAuditLogActionJson→AuditLogActionAuditLogExportJson→AuditLogExportAuditLogsRetentionJson→AuditLogsRetentionWebhookEndpointJson→WebhookEndpoint,WebhookEndpointJsonStatus→WebhookEndpointStatusRadarAction→RadarListAction,RadarType→RadarListTypeAuditLogSchemarenamed toAuditLogSchemaDto; newAuditLogSchemaInput,AuditLogSchemaActorInput,AuditLogSchemaTargetInputtypes added
Features
- vault: Add Vault service with key management and object storage APIs
- New
VaultApiservice providing encryption key management and encrypted object storage - Key management:
create_data_key,create_decrypt,create_rekeyfor cryptographic operations - Object storage:
list_kv,create_kv,get_kv,get_name,update_kv,delete_kvfor managing encrypted key-value pairs - Metadata operations:
list_kv_metadataandlist_kv_versionsfor inspecting object history without decryption - api_key: Add expires_at field to API key models
- New optional
expires_atfield added toApiKey,OrganizationApiKey,OrganizationApiKeyWithValue,UserApiKey,UserApiKeyWithValuemodels - Allows setting expiration timestamps on API keys; null means no expiration
- Event data models updated:
ApiKeyCreatedDataandApiKeyRevokedDatanow includeexpires_at - New optional parameter
expires_atinCreateOrganizationApiKeyandCreateUserApiKeyrequest bodies - webhooks: Add Pipes connected account events to webhook subscriptions
- Three new webhook event types for Pipes integrations:
PIPES_CONNECTED_ACCOUNT_CONNECTED,PIPES_CONNECTED_ACCOUNT_DISCONNECTED,PIPES_CONNECTED_ACCOUNT_REAUTHORIZATION_NEEDED - New model types:
PipeConnectedAccount,PipesConnectedAccountConnected,PipesConnectedAccountDisconnected,PipesConnectedAccountReauthorizationNeeded - New enum
PipeConnectedAccountStatefor connected account status tracking - connect: Add typed connect application models and new fields
- New
ConnectApplicationM2MandConnectApplicationOAuthmodel types for M2M and OAuth applications - New fields on
ConnectApplication:redirect_uris,uses_pkce,is_first_party,was_dynamically_registered - New
ConnectApplicationRedirectUriandConnectApplicationOAuthRedirectUristypes - generated: Add new general-purpose models
- New
Actormodel for representing users or API keys that performed actions - New
ErrorResponsemodel for structured error response bodies - New
ListMetadatamodel for cursor-based pagination metadata - New
VaultOrderenum for ordering vault list results
Fixes
- generated: Standardize type names and fix parameter defaults in authorization service
- Added
resource_id,resource_external_id, andresource_type_slugfilters toListRoleAssignmentsParamsfor more granular assignment filtering - Added
role_slugfilter toListRoleAssignmentsForResourceParamsandListRoleAssignmentsForResourceByExternalIdParams - Removed
searchparameter fromListResourcesParams(deprecated) - connect: Fix last_used_at field type in application credentials
NewConnectApplicationSecret.last_used_attype changed from invalid string value to ISO 8601 timestampApplicationCredentialsListItem.last_used_attype changed from invalid string value to ISO 8601 timestamp- Ensures consistency with API contract for credential timestamp tracking
- sso: Expand login_hint documentation to include custom SAML
- Updated
GetAuthorizationUrlParams.login_hintdocumentation to indicate support for custom SAML connections in addition to existing OAuth/OpenID Connect/Okta/Entra ID support
May 13, 2026
v1.0.1
May 13, 2026
v1.0.0...v1.0.1" rel="noreferrer" target="_blank">1.0.1 (2026-05-13)
Bug Fixes
- generated: Regenerate from oagen with query encoder + typed param bodies (https://github.com/workos/workos-rust/commit/e63d620673b1e0b1270b1ca0ad7539d462c94e51" rel="noreferrer" target="_blank">e63d620)
May 12, 2026
v1.0.0
May 12, 2026
v0.8.1...v1.0.0" rel="noreferrer" target="_blank">1.0.0 (2026-05-10)
⚠ BREAKING CHANGES
- prep for v1
Features
- Add ApiError, RequestOptions, and auto-paging streams (https://github.com/workos/workos-rust/commit/a1a66ba8cad6f8d79456c4f951cd00b1c0d8b108" rel="noreferrer" target="_blank">a1a66ba)
- client: Add path_segment encoder and shared auto-paging driver (https://github.com/workos/workos-rust/commit/7f1c2d3b2490b588bf32abb8b5c76e1c0598e9e4" rel="noreferrer" target="_blank">7f1c2d3)
- client: Gate retries by safety and add per-request RequestStrategy (https://github.com/workos/workos-rust/commit/1fb9b1c8835daeb77f603b689418b0860352de6c" rel="noreferrer" target="_blank">1fb9b1c)
- prep for v1 (https://github.com/workos/workos-rust/commit/9b42e7753ae5b73ebcfb7cba9cebd9967a49c94f" rel="noreferrer" target="_blank">9b42e77)
- secret: Add SecretString wrapper for sensitive fields (https://github.com/workos/workos-rust/commit/d3729a98c9ce6c9bf654779e8c252c7887f83cd5" rel="noreferrer" target="_blank">d3729a9)
Bug Fixes
- helpers: Harden webhook, session, and vault crypto paths (https://github.com/workos/workos-rust/commit/98b8a59781d461a78b429c4757224d86a4bb68be" rel="noreferrer" target="_blank">98b8a59)
July 14, 2022
v0.2.0
July 14, 2022
Added
- Added
organization_idtoDirectoryUsers andDirectoryGroups (https://github.com/workos/workos-rust/pull/84" rel="noreferrer" target="_blank">#84)
July 11, 2022
v0.1.1
July 11, 2022
Changed
- Updated the endpoints used for
ChallengeFactorandVerifyChallengeoperations (https://github.com/workos/workos-rust/pull/81" rel="noreferrer" target="_blank">#81) - Changed project status to "experimental" (https://github.com/workos/workos-rust/pull/82" rel="noreferrer" target="_blank">#82)
July 1, 2022
v0.1.0
July 1, 2022
Added
- Initial release