WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Python SDK

github.com
workos/workos-python
63 Stars
24 Forks
52 Contributors
github.com
Official Python SDK for interacting with the WorkOS API.

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 https://github.com/workos/workos-python/pull/502
  • v5.37.0 by @stanleyphu in https://github.com/workos/workos-python/pull/503

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/500
  • v5.36.0 by @rarevalo13 in https://github.com/workos/workos-python/pull/501

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/491

New Contributors

  • @denizs made their first contribution in https://github.com/workos/workos-python/pull/491

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/498
  • Add roles to directory sync user and sso profile by @kendallstrautman in https://github.com/workos/workos-python/pull/497

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/497

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/494

Full Changelog: https://github.com/workos/workos-python/compare/v5.32.0...5.33.0

October 27, 2025

v5.32.0

October 27, 2025

What's Changed

  • Added locale to user (https://github.com/workos/workos-python/pull/478)

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/485

New Contributors

  • @dsinghvi made their first contribution in https://github.com/workos/workos-python/pull/485

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/481
  • bump to v5.30.0 by @simzeee in https://github.com/workos/workos-python/pull/482

New Contributors

  • @simzeee made their first contribution in https://github.com/workos/workos-python/pull/481

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/475
  • Add support for list organization feature flags endpoint by @stanleyphu in https://github.com/workos/workos-python/pull/476
  • Bump to v5.29.0 by @stanleyphu in https://github.com/workos/workos-python/pull/477

New Contributors

  • @antn made their first contribution in https://github.com/workos/workos-python/pull/475

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/471
  • Add multiple roles support by @csrbarber in https://github.com/workos/workos-python/pull/473
  • Bump version to 5.28.0 by @csrbarber in https://github.com/workos/workos-python/pull/474

New Contributors

  • @blackmad-cradle made their first contribution in https://github.com/workos/workos-python/pull/471
  • @csrbarber made their first contribution in https://github.com/workos/workos-python/pull/473

Full Changelog: https://github.com/workos/workos-python/compare/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 (https://github.com/workos/workos-python/pull/469)

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/466

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/464
  • Bump to v5.26.0 by @ajworkos in https://github.com/workos/workos-python/pull/465

Full Changelog: https://github.com/workos/workos-python/compare/v5.24.0...v5.26.0

July 8, 2025

v5.24.0

July 8, 2025

What's Changed

  • Added support for WorkOS Vault https://github.com/workos/workos-python/pull/458
  • Added organization_domain events https://github.com/workos/workos-python/pull/457

Full Changelog: (https://github.com/workos/workos-python/compare/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 (https://github.com/workos/workos-python/pull/454)

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/442
  • Bump to 5.21.0 by @atainter in https://github.com/workos/workos-python/pull/443

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/440
  • Bump to v5.20.2 by @gcarvelli in https://github.com/workos/workos-python/pull/441

New Contributors

  • @na-ka-na made their first contribution in https://github.com/workos/workos-python/pull/440

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/438
  • Bump to v5.20.1 by @stanleyphu in https://github.com/workos/workos-python/pull/439

New Contributors

  • @stanleyphu made their first contribution in https://github.com/workos/workos-python/pull/438

Full Changelog: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/436

Full Changelog: https://github.com/workos/workos-python/compare/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 (https://github.com/workos/workos-python/pull/429)

Full Changelog: https://github.com/workos/workos-python/compare/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: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/424

Full Changelog: https://github.com/workos/workos-python/compare/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: https://github.com/workos/workos-python/compare/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 https://github.com/workos/workos-python/pull/420

Full Changelog: https://github.com/workos/workos-python/compare/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: https://github.com/workos/workos-python/compare/v5.15.0...v5.15.1