7.0.0 (2026-04-20)
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.
-
Client-centric architecture: The SDK now revolves around an instantiated
WorkOS::Clientrather 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
SessionManageron the client instance. -
New capabilities: Device code flow, public/PKCE clients,
auto_paging_eachpagination, andlast_responseobservability on all responses.
For detailed instructions on updating your application, see the v7 Migration Guide.
6.2.0 (2026-03-06)
- user-management: add directory_managed to OrganizationMembership (#446) (914d824)
- user-management: add invitation accept endpoint (#448) (b5b4da1)