Installation

Command Line
Python

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 the beta versions, refer to the README in the GitHub repository.

Releases

December 17, 2025

v5.37.0

Latest
December 17, 2025

What's Changed

  • Add support for list user feature flags endpoint by @stanleyphu in #502
  • v5.37.0 by @stanleyphu in #503

Full Changelog: v5.36.0...v5.37.0

December 16, 2025

v5.36.0

December 16, 2025

What's Changed

  • adding "session.revoke" to events type by @rarevalo13 in #500
  • v5.36.0 by @rarevalo13 in #501

Full Changelog: v5.35.0...v5.36.0

December 5, 2025

v5.35.0

December 5, 2025

What's Changed

  • Expose api key validation by @denizs in #491

New Contributors

  • @denizs made their first contribution in #491

Full Changelog: v5.34.1...v5.35.0

December 2, 2025

v5.34.1

December 2, 2025

What's Changed

  • bump version v5.34.1 by @kendallstrautman in #498
  • Add roles to directory sync user and sso profile by @kendallstrautman in #497

Full Changelog: v5.33.0...v5.34.1

December 2, 2025

v5.34.0

December 2, 2025

⚠️ Misconfigured release version. Use v5.34.1 instead

In this version, the package semver was not updated properly and still references v5.33.0

What's Changed

  • Add roles to directory sync user and sso profile by @kendallstrautman in #497

Full Changelog: 5.33.0...v5.34.0

November 21, 2025

5.33.0

November 21, 2025

What's Changed

  • Add ability to resend invitations by @antn in #494

Full Changelog: v5.32.0...5.33.0

October 27, 2025

v5.32.0

October 27, 2025

What's Changed

  • Added locale to user (#478)

Full Changelog: v5.31.2...v5.32.0

October 20, 2025

v5.31.2

October 20, 2025

What's Changed

  • fix: parse email verification id in exception by @dsinghvi in #485

New Contributors

  • @dsinghvi made their first contribution in #485

Full Changelog: v5.31.1...v5.31.2

October 15, 2025

v5.31.1

October 15, 2025
  • Updates response for revoke_session method to none
October 14, 2025

v5.31.0

October 14, 2025
  • Add list sessions API (sync/async): GET user_management/users/{user_id}/sessions
  • Add revoke session API (sync/async): POST user_management/sessions/revoke
  • New typed model: workos.types.user_management.Session
October 9, 2025

v5.30.0

October 9, 2025

What's Changed

  • add authenticate with invite_token to authenticate_with_code by @simzeee in #481
  • bump to v5.30.0 by @simzeee in #482

New Contributors

  • @simzeee made their first contribution in #481

Full Changelog: v5.29.0...v5.30.0

October 2, 2025

v5.29.0

October 2, 2025

What's Changed

  • Add Salesforce OAuth as an authentication provider by @antn in #475
  • Add support for list organization feature flags endpoint by @stanleyphu in #476
  • Bump to v5.29.0 by @stanleyphu in #477

New Contributors

  • @antn made their first contribution in #475

Full Changelog: v5.28.0...v5.29.0

September 18, 2025

v5.28.0

September 18, 2025

What's Changed

  • Fix missing organization_domain events in webhook defs by @blackmad-cradle in #471
  • Add multiple roles support by @csrbarber in #473
  • Bump version to 5.28.0 by @csrbarber in #474

New Contributors

  • @blackmad-cradle made their first contribution in #471
  • @csrbarber made their first contribution in #473

Full Changelog: v5.27.0...v5.28.0

August 20, 2025

v5.27.0

August 20, 2025

What's Changed

  • Added invitation.accepted and invitation.revoked events (#469)

Full Changelog: v5.26.1...v5.27.0

July 31, 2025

v5.26.1

July 31, 2025

What's Changed

  • Cache JWKS clients per URL by @dandorman in #466

Full Changelog: v5.26.0...v5.26.1

July 31, 2025

v5.26.0

July 31, 2025

What's Changed

  • Add organization domains module by @ajworkos in #464
  • Bump to v5.26.0 by @ajworkos in #465

Full Changelog: v5.24.0...v5.26.0

July 8, 2025

v5.24.0

July 8, 2025

What's Changed

Full Changelog: (v5.23.0...v5.24.0)[]

June 2, 2025

v5.23.0

June 2, 2025

What's Changed

  • Added support for provider_scopes query param (#454)

Full Changelog: v5.22.0...v5.23.0

May 22, 2025

v5.22.0

May 22, 2025

What's Changed

  • Add email as option to UserManagement.update_user (#452)
May 9, 2025

v5.21.0

May 9, 2025

What's Changed

  • Add warnings field to FGA check / query response by @atainter in #442
  • Bump to 5.21.0 by @atainter in #443

Full Changelog: v5.20.2...v5.21.0

May 2, 2025

v5.20.2

May 2, 2025

What's Changed

  • Avoid decoding jwt twice by @na-ka-na in #440
  • Bump to v5.20.2 by @gcarvelli in #441

New Contributors

  • @na-ka-na made their first contribution in #440

Full Changelog: v5.20.1...v5.20.2

May 1, 2025

v5.20.1

May 1, 2025

What's Changed

  • Convert context into query string for FGA queries by @stanleyphu in #438
  • Bump to v5.20.1 by @stanleyphu in #439

New Contributors

  • @stanleyphu made their first contribution in #438

Full Changelog: v5.20.0...v5.20.1

April 25, 2025

v5.20.0

April 25, 2025

What's Changed

  • Bump cryptography to ~=44.0.2 (#436)
  • Add custom_attributes field to SSO Profile (#434)

New Contributors

  • @Adamruns made their first contribution in #436

Full Changelog: v5.19.1...v5.20.0

April 17, 2025

v5.19.1

April 17, 2025

What's Changed

  • Allow organization_id to be optional on Connection for OAuth connections (#432)
  • Fix async session tests (#433)

Full Changelog: v5.19.0...v5.19.1

April 15, 2025

v5.19.0

April 15, 2025

What's Changed

  • Added password_reset.succeeded event type (#429)

Full Changelog: v5.18.1...v5.19.0

April 1, 2025

v5.18.1

April 1, 2025

What's Changed

  • Use AsyncSession class for async load_sealed_session (#427)

Full Changelog: v5.18.0...v5.18.1

March 31, 2025

v5.18.0

March 31, 2025

What's Changed

  • Loosen dependency version constraints by @mrcljx in #424
  • Add async support for load_sealed_session in #425

New Contributors

  • @mrcljx made their first contribution in #424

Full Changelog: v5.17.0...v5.18.0

March 21, 2025

v5.17.0

March 21, 2025

What's Changed

  • Add email standard attribute to DirectoryUser
  • Mark emails, job_title, and username standard attributes as deprecated. Enable the equivalent auto-mapped custom attributes instead (#413)

Full Changelog: v5.16.0...v5.17.0

March 19, 2025

v5.16.0

March 19, 2025

What's Changed

  • Add metadata and external id to users and organizations from #420

Full Changelog: v5.15.1...v5.16.0

March 17, 2025

v5.15.1

March 17, 2025

What's Changed

  • Add missing list of workos module public symbols to allow importing like from workos import WorkOSClient (#415)

Full Changelog: v5.15.0...v5.15.1