Skip to main content

WorkOS Python Client

Project description

WorkOS Python Library

PyPI Build Status

The WorkOS library for Python provides convenient access to the WorkOS API from applications written in Python, hosted on PyPi

Documentation

See the API Reference for Python usage examples.

Installation

To install from PyPi, run the following:

pip install workos

To install from source, clone the repo and run the following:

python -m pip install .

Configuration

The package will need to be configured with your api key and client ID.

from workos import WorkOSClient

workos_client = WorkOSClient(
    api_key="sk_1234", client_id="client_1234"
)

The SDK also provides asyncio support for some SDK methods, via the async client:

from workos import AsyncWorkOSClient

async_workos_client = AsyncWorkOSClient(
    api_key="sk_1234", client_id="client_1234"
)

SDK Versioning

For our SDKs WorkOS follows a Semantic Versioning (SemVer) process where all releases will have a version X.Y.Z (like 1.0.0) pattern wherein Z would be a bug fix (e.g., 1.0.1), Y would be a minor release (1.1.0) and X would be a major release (2.0.0). We permit any breaking changes to only be released in major versions and strongly recommend reading changelogs before making any major version upgrades.

Beta Releases

WorkOS has features in Beta that can be accessed via Beta releases. We would love for you to try these and share feedback with us before these features reach general availability (GA). To install a Beta version, please follow the installation steps above using the Beta release version.

Note: there can be breaking changes between Beta versions. Therefore, we recommend pinning the package version to a specific version. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest Beta version.

We highly recommend keeping an eye on when the Beta feature you are interested in goes from Beta to stable so that you can move to using the stable version.

More Information

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workos-5.40.1.tar.gz (55.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

workos-5.40.1-py3-none-any.whl (103.5 kB view details)

Uploaded Python 3

File details

Details for the file workos-5.40.1.tar.gz.

File metadata

  • Download URL: workos-5.40.1.tar.gz
  • Upload date:
  • Size: 55.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for workos-5.40.1.tar.gz
Algorithm Hash digest
SHA256 16686b6dba31182c8362683b9f0ae64ebbcd8f7468be48513101861c374435d4
MD5 3d8547d35f5529801aae711be80cfefe
BLAKE2b-256 8f4a6c75e60c9f8c1ba7e1520c3ea88f39a108e6b0296b05b945370ef1fdad18

See more details on using hashes here.

File details

Details for the file workos-5.40.1-py3-none-any.whl.

File metadata

  • Download URL: workos-5.40.1-py3-none-any.whl
  • Upload date:
  • Size: 103.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for workos-5.40.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f3448c04e28d2e7bbe3689c7506ce6ef0888b8e281b0417876df77614007f2fd
MD5 4fb6030cf65e68180a1f4ab08117f7b2
BLAKE2b-256 7d2c052d994f3dd939ab2583162b7cd3de06a6b3b0936f16ff59efc349c73048

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page