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

January 22, 2026

v5.40.0

Latest
January 22, 2026

What's Changed

  • ci: Migrate release workflow to Trusted Publishing by @birdcar in #517
  • Implement the remaining Audit Logs functionality by @birdcar in #515
  • Use correct var/secret names by @gjtorikian in #522
  • v5.40.0 by @workos-sdk-automation[bot] in #523

New Contributors

  • @workos-sdk-automation[bot] made their first contribution in #523

Full Changelog: v5.39.1...v5.40.0

January 20, 2026

v5.39.1

January 20, 2026

What's Changed

  • Allow for same param name but different contextual usage by @gjtorikian in #520
  • Bump to 5.39.1 by @gjtorikian in #521

Full Changelog: v5.39.0...5.39.1

January 15, 2026

v5.39.0

January 15, 2026

What's Changed

  • Add context7.json to repo by @nicknisi in #504
  • Add read_object_by_name method for Vault API by @hexedpackets in #506
  • Add Python SDK support for WorkOS Pipes by @birdcar in #507
  • Bump version to v5.38.0 by @birdcar in #509
  • Add new supported password hash types by @alastair in #461
  • Move from setup.py to uv+pyproject.toml by @birdcar in #496
  • Remove unused pypi environment for now by @birdcar in #513
  • Correct params for list_groups and list_users by @gjtorikian in #512
  • Release 5.38.1 by @birdcar in #514
  • Add nox and nox-uv for DX testing improvements by @birdcar in #516
  • v5.39.0 by @nicknisi in #518

New Contributors

  • @hexedpackets made their first contribution in #506
  • @birdcar made their first contribution in #507
  • @alastair made their first contribution in #461
  • @gjtorikian made their first contribution in #512

Full Changelog: v5.37.0...v5.39.0

January 13, 2026

v5.38.1

January 13, 2026

What's Changed

  • Add new supported password hash types by @alastair in #461
  • Move from setup.py to uv+pyproject.toml by @birdcar in #496
  • Correct params for list_groups and list_users by @gjtorikian in #512
  • Add Support for a JWT Leeway Parameter by @Th3R3p0 in #430

New Contributors

  • @Th3R3p0 made their first contribution in #430
  • @alastair made their first contribution in #461

Full Changelog: v5.38.0...v5.38.1

January 12, 2026

v5.38.0

January 12, 2026

What's Changed

  • Add context7.json to repo by @nicknisi in #504
  • Add read_object_by_name method for Vault API by @hexedpackets in #506
  • Add Python SDK support for WorkOS Pipes by @birdcar in #507

Full Changelog: v5.37.0...v5.38.0

December 17, 2025

v5.37.0

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