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

April 13, 2026

v6.0.1

Latest
April 13, 2026

6.0.1 (2026-04-13)

Bug Fixes

April 13, 2026

v6.0.0

April 13, 2026

6.0.0 (2026-04-13)

Top-level notices

  • v6 is a breaking release and now requires Python 3.10 or newer.
  • The SDK now uses generated sync and async clients with top-level imports from workos.
  • client.portal has been renamed to client.admin_portal, and client.fga is not available in v6.

What's changed

  • Rebuilt the Python SDK around a generated client/runtime with updated request handling, pagination, typed models, and error surfaces.
  • Reorganized package exports and service modules to support the new v6 client shape across the SDK.
  • Added release validation coverage, including package smoke tests and the runtime dependency updates needed for packaged installs.

See the V6 migration guide before upgrading from v5.

March 16, 2026

v5.46.0

March 16, 2026

5.46.0 (2026-03-16)

Features

Bug Fixes

  • Allow organization_name to be empty on organization membership events (#595) (865aeb5)
  • deps: update dependency pyjwt to v2.12.0 [security] (#589) (0d50534)
March 9, 2026

v5.45.0

March 9, 2026

5.45.0 (2026-03-09)

Features

  • return organization_name on OrganizationMembership (#574) (dae4dab)

Bug Fixes

  • list_client_secrets returns raw list, not paginated response (#586) (ccc8cd5)
March 9, 2026

v5.44.0

March 9, 2026

5.44.0 (2026-03-06)

Features

  • Add Connect Applications and Client Secrets module (#585) (1ad1623)
  • add cross app auth method (#577) (c67972f)
  • add resource_type_slug to permissions, environment and organization roles (#576) (1004bd7)
  • user-management: add directory_managed to OrganizationMembership (#583) (f0e716e)
March 5, 2026

v5.43.0

March 5, 2026

5.43.0 (2026-03-05)

Features

Bug Fixes

February 20, 2026

v5.42.1

February 20, 2026

What's Changed

  • Fix outdated organization_membership events by @mattgd in #560
  • v5.42.1 by @workos-sdk-automation[bot] in #562

Full Changelog: v5.42.0...v5.42.1

February 17, 2026

v5.42.0

February 17, 2026

What's Changed

  • Add permission and organization role support by @csrbarber in #548
  • feat: Add ability to accept invitations by @gjtorikian in #552
  • v5.42.0 by @workos-sdk-automation[bot] in #553

Full Changelog: v5.41.0...v5.42.0

February 12, 2026

v5.41.0

February 12, 2026

What's Changed

  • chore: Configure Renovate by @renovate[bot] in #527
  • chore(deps): update actions/create-github-app-token action to v2 by @renovate[bot] in #536
  • Bump cryptography from 46.0.3 to 46.0.5 by @dependabot[bot] in #540
  • Add sso subdict to sso auth events by @blackmad-cradle in #542
  • chore(deps): update dependency node to v24 by @renovate[bot] in #539
  • chore(deps): update actions/checkout action to v6 by @renovate[bot] in #535
  • Add missing event types by @blackmad-cradle in #543
  • Add API Keys support (create, list, delete) by @blackmad-cradle in #544
  • v5.41.0 by @workos-sdk-automation[bot] in #547

New Contributors

  • @renovate[bot] made their first contribution in #527
  • @dependabot[bot] made their first contribution in #540

Full Changelog: v5.40.1...v5.41.0

February 4, 2026

v5.40.1

February 4, 2026

What's Changed

  • Add custom_attributes field to OrganizationMembership by @ajworkos in #524
  • Add accepted_user_id to invitation by @gjtorikian in #525
  • v5.40.1 by @workos-sdk-automation[bot] in #526

Full Changelog: v5.40.0...v5.40.1

January 22, 2026

v5.40.0

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