Rust

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 28, 2026

v2.0.1

Latest
May 28, 2026

Bug Fixes

May 26, 2026

v2.0.0

May 26, 2026

⚠️ Breaking

  • organization_membership: Split organization membership operations from user_management into dedicated service
  • New OrganizationMembershipApi service 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_management and moved to organization_membership (see compat_breaking list)
  • Role enum (Single/Multiple variants) moved from user_management to organization_membership
  • client.user_management_organization_membership_groups() removed; use client.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") and SignIn ("sign in", "sign_in"); only canonical wire values "sign-up" and "sign-in" are accepted
  • Removed fields from RadarStandaloneAssessRequest: device_fingerprint and bot_score (marked breaking in spec)
  • vault: Replaced hand-written helpers::VaultApi with generated resources::VaultApi
  • client.vault() now returns resources::VaultApi instead of helpers::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/decrypt convenience methods preserved on resources::VaultApi with the same behavior
  • Crypto helpers moved from helpers::vault to helpers::vault_crypto (re-exported: VaultEncryptResult, local_encrypt, local_decrypt, extract_encrypted_keys)
  • generated: Rename types to remove Json suffix and standardize naming
  • AuditLogExportJsonStateAuditLogExportState
  • AuditLogActionJsonAuditLogAction
  • AuditLogExportJsonAuditLogExport
  • AuditLogsRetentionJsonAuditLogsRetention
  • WebhookEndpointJsonWebhookEndpoint, WebhookEndpointJsonStatusWebhookEndpointStatus
  • RadarActionRadarListAction, RadarTypeRadarListType
  • AuditLogSchema renamed to AuditLogSchemaDto; new AuditLogSchemaInput, AuditLogSchemaActorInput, AuditLogSchemaTargetInput types added

Features

  • vault: Add Vault service with key management and object storage APIs
  • New VaultApi service providing encryption key management and encrypted object storage
  • Key management: create_data_key, create_decrypt, create_rekey for cryptographic operations
  • Object storage: list_kv, create_kv, get_kv, get_name, update_kv, delete_kv for managing encrypted key-value pairs
  • Metadata operations: list_kv_metadata and list_kv_versions for inspecting object history without decryption
  • api_key: Add expires_at field to API key models
  • New optional expires_at field added to ApiKey, OrganizationApiKey, OrganizationApiKeyWithValue, UserApiKey, UserApiKeyWithValue models
  • Allows setting expiration timestamps on API keys; null means no expiration
  • Event data models updated: ApiKeyCreatedData and ApiKeyRevokedData now include expires_at
  • New optional parameter expires_at in CreateOrganizationApiKey and CreateUserApiKey request 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 PipeConnectedAccountState for connected account status tracking
  • connect: Add typed connect application models and new fields
  • New ConnectApplicationM2M and ConnectApplicationOAuth model types for M2M and OAuth applications
  • New fields on ConnectApplication: redirect_uris, uses_pkce, is_first_party, was_dynamically_registered
  • New ConnectApplicationRedirectUri and ConnectApplicationOAuthRedirectUris types
  • generated: Add new general-purpose models
  • New Actor model for representing users or API keys that performed actions
  • New ErrorResponse model for structured error response bodies
  • New ListMetadata model for cursor-based pagination metadata
  • New VaultOrder enum for ordering vault list results

Fixes

  • generated: Standardize type names and fix parameter defaults in authorization service
  • Added resource_id, resource_external_id, and resource_type_slug filters to ListRoleAssignmentsParams for more granular assignment filtering
  • Added role_slug filter to ListRoleAssignmentsForResourceParams and ListRoleAssignmentsForResourceByExternalIdParams
  • Removed search parameter from ListResourcesParams (deprecated)
  • connect: Fix last_used_at field type in application credentials
  • NewConnectApplicationSecret.last_used_at type changed from invalid string value to ISO 8601 timestamp
  • ApplicationCredentialsListItem.last_used_at type 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_hint documentation 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

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

Bug Fixes

July 14, 2022

v0.2.0

July 14, 2022

Added

July 11, 2022

v0.1.1

July 11, 2022

Changed

July 1, 2022

v0.1.0

July 1, 2022

Added

  • Initial release