WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Python SDK

github.com
workos/workos-python
58 Stars
21 Forks
48 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

October 14, 2025

v5.31.0

Latest
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

February 14, 2025

v5.15.0

February 14, 2025

What's Changed

Added

  • Added last_sign_in_at to user (#408)

Changed

  • Fixed handling access tokens with aud claim (#409)

Full Changelog: https://github.com/workos/workos-python/compare/v5.14.0...v5.15.0

February 3, 2025

v5.14.0

February 3, 2025

What's Changed

  • Add intent_options parameter on Portal.generate_link() method by @jonatascastro12 in https://github.com/workos/workos-python/pull/406
January 24, 2025

v5.13.1

January 24, 2025

What's Changed

  • Adjust dependency version pinning to allow for more cryptography versions (#404)

Full Changelog: https://github.com/workos/workos-python/compare/v5.13.0...v5.13.1

January 14, 2025

v5.13.0

January 14, 2025

Added

  • Added strip_customer_id parameter to update_organization (#401)
  • Added return_to parameter to get_logout_url (#400)

Full Changelog: https://github.com/workos/workos-python/compare/v5.12.1...v5.13.0

January 13, 2025

v5.12.1

January 13, 2025

What's Changed

  • Allows proxies to be properly set via environment variables (#398). If you use the standard HTTP proxy environment variables (e.g. HTTPS_PROXY), it's recommend to verify there's no behavior change in your environment and adjust them if needed.

Full Changelog: https://github.com/workos/workos-python/compare/v5.12.0...v5.12.1

January 7, 2025

v5.12.0

January 7, 2025

Added

  • Support screen_hint in user_management.get_authorization_url by @faroceann in https://github.com/workos/workos-python/pull/396

Full Changelog: https://github.com/workos/workos-python/compare/v5.11.1...v5.12.0

January 6, 2025

v5.11.1

January 6, 2025

What's Changed

  • Update dependency versions pinning (#394)

Full Changelog: https://github.com/workos/workos-python/compare/v5.11.0...v5.11.1

January 2, 2025

v5.11.0

January 2, 2025

What's Changed

  • Add GET /organization/:orgId/roles API support (#392)

Full Changelog: https://github.com/workos/workos-python/compare/v5.10.0...v5.11.0

December 2, 2024

v5.10.0

December 2, 2024

What's Changed

  • Propagate ConflictExceptions properly by @mattgd in https://github.com/workos/workos-python/pull/389
  • Adds session helpers by @PaulAsjes in https://github.com/workos/workos-python/pull/384

Full Changelog: https://github.com/workos/workos-python/compare/v5.9.0...v5.10.0