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 the beta versions, refer to the README in the GitHub repository.
generated: update generated SDK from spec changes (#465) (6c145d2)
Bug Fixes
add ruby/setup-ruby to release-please workflow (aa5ebd0)
eagerly load configuration.rb to fix WorkOS.configure (#467) (eea391c)
remove stale URN-prefixed alias files breaking Zeitwerk (#466) (92b2aa5)
update Gemfile.lock in release-please PR and bump action pins (2aa0574)
update Zeitwerk autoload for inflections.rb (#460) (4fa1332)
April 20, 2026
v7.0.0
April 20, 2026
This is a major release that introduces a fully redesigned SDK architecture. The SDK is now generated from the WorkOS OpenAPI spec, bringing type safety, consistent interfaces, and improved developer ergonomics.
High-Level Changes
Client-centric architecture: The SDK now revolves around an instantiated WorkOS::Client rather than module-level service calls. All product areas are accessed through client methods (e.g., client.organizations, client.user_management, client.sso).
Generated request/response models: Typed models replace raw hashes. Response models no longer inherit from Hash — use accessor methods instead of bracket notation.
Per-request overrides: The new runtime supports request_options: for per-request API key, timeout, base URL, and retry overrides — useful for multi-tenant setups.
Minimum Ruby 3.3+: The minimum Ruby version has been raised to 3.3.
Renamed services and methods: Several top-level services were renamed (e.g., WorkOS::Portal → client.admin_portal, WorkOS::MFA → client.multi_factor_auth). Method signatures now use explicit keyword arguments.
Session management refactor: AuthKit session sealing, refresh, and authentication flows were overhauled with a dedicated SessionManager on the client instance.
New capabilities: Device code flow, public/PKCE clients, auto_paging_each pagination, and last_response observability on all responses.
Migration Guide
For detailed instructions on updating your application, see the v7 Migration Guide.