Skip to main content

Burdenoff Workspaces SDK for Python

burdenoff-workspaces-sdk is the official async Python client for the Burdenoff Workspaces platform API.

It is a thin shell over burdenoff-sdk-libs: every GraphQL operation lives in a shared sdk-libs module, so this SDK, the Workspaces CLI and the other Burdenoff product SDKs send the same documents. This package picks the modules the Workspaces product exposes, points them at the production gateways and gives you one typed client.

Install

pip install burdenoff-workspaces-sdk

Python 3.10 or newer.

Quick start

import asyncio
import os

from burdenoff_sdk_libs.modules.auth.types import SignInInput
from workspaces_sdk import WorkspacesSDK


async def main() -> None:
    sdk = WorkspacesSDK()  # production endpoints by default
    try:
        await sdk.auth.sign_in(
            SignInInput(
                username=os.environ["WORKSPACES_EMAIL"],
                password=os.environ["WORKSPACES_PASSWORD"],
            )
        )
        me = await sdk.auth.get_current_user()
        print("Signed in as", me.email)

        workspaces = await sdk.workspaces.list()
        for workspace in workspaces.items:
            print(workspace.id, workspace.name)
    finally:
        await sdk.close()


asyncio.run(main())

Other ways to authenticate:

  • sdk.auth.login_with_api_key(key) for an API key.
  • sdk.auth.login_with_client_credentials(client_id, client_secret) for an app.
  • sdk.auth.login_with_device_code() for the OAuth2 device-code flow.
  • Pass access_token= / refresh_token= to the constructor to reuse tokens.

Workspace-scoped calls use the token you get from sdk.auth.issue_workspace_token(workspace_id, organization_id).

Modules

Attribute What it covers
auth Sign in/up, OAuth device code and PKCE, API keys, current user, workspace tokens
workspaces Workspaces, members, projects, invites, activity log
organizations Organizations, members, invites
tags Universal tags and tag analytics
groups Groups, members, hierarchy
conversations Conversations, messages, threads, reactions
files Files, folders, sharing
notifications Notification inbox and preferences
rbac Roles, policies, permission checks
integrations Integration providers and connections
security Vaults and secrets
export Export jobs and templates
products Products, shortcuts, content pages, feature flags
store Marketplace search, cart, orders, installed apps
support Support tickets and knowledge base
tours Product tours and progress
health Gateway health checks

Billing, channels, developer portal, sandbox and scheduler are not mounted yet: some of their sdk-libs operations do not match the production schema. They will be added once sdk-libs repairs them.

Endpoints

Defaults are the production gateways. Override them per client or by environment variable:

Precedence Workspace gateway Global gateway
Constructor workspace_endpoint= global_endpoint=
Product env WORKSPACES_WORKSPACE_ENDPOINT WORKSPACES_GLOBAL_ENDPOINT
Generic env BURDENOFF_WORKSPACE_ENDPOINT BURDENOFF_GLOBAL_ENDPOINT
Default https://graphqlworkspaces.burdenoff.com/workspaces/graphql https://graphql.burdenoff.com/global/graphql

Development

uv sync --all-extras
uv run pytest            # unit tests, mocked transport, no network
uv run flake8 src/

Releasing

Releases are CalVer (YYYY.MDD.PATCH) and run through .github/workflows/release.yml, the shared algoshred/dev release-pypi workflow. Push a CalVer tag on a commit that is on main, or dispatch the workflow with an empty version to take today's next free patch. The version is stamped at build time and never committed back. Guide: dev/platform/context/delivery/cicd/HOW_TO_RELEASE_CLIENT_PACKAGES.md.

Documentation

https://docs.burdenoff.com/developers/python-sdk

License

Proprietary. Copyright Burdenoff Consultancy Services Pvt. Ltd.

Metadata

Release files for burdenoff-workspaces-sdk 2026.1102.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for burdenoff-workspaces-sdk 2026.1102.1
File Size Uploaded Provenance Actions
burdenoff_workspaces_sdk-2026.1102.1.tar.gz 14.5 kB Without provenance Details for burdenoff_workspaces_sdk-2026.1102.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for burdenoff-workspaces-sdk 2026.1102.1
File Interpreter ABI Platform Actions
burdenoff_workspaces_sdk-2026.1102.1-py3-none-any.whl Python 3 none any Details for burdenoff_workspaces_sdk-2026.1102.1-py3-none-any.whl

Total release size: 23.4 kB

Release files / burdenoff_workspaces_sdk-2026.1102.1.tar.gz

Download URL burdenoff_workspaces_sdk-2026.1102.1.tar.gz
Size 14.5 kB
Tags Source
SHA-256 checksum
How to use checksums
1c0abbc006b9abb768e5bb8e91e71c05d805989d3585bc429a0570258b7d26f2
BLAKE2b-256 checksum
How to use checksums
48e750a3892138ff063a318009f2727d45852631b7b2b2901ee7a1cdf84438c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / burdenoff_workspaces_sdk-2026.1102.1-py3-none-any.whl

Download URL burdenoff_workspaces_sdk-2026.1102.1-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
715611c81e4d4bbc1bb7a5cd70147968fb3ecfcbfcfcba8098fa66e11e75baf5
BLAKE2b-256 checksum
How to use checksums
5a5789decb598e9486c3cab1bbf1196c961d90d822961ff0312bb63ce1aabaf9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for burdenoff-workspaces-sdk 2026.1102.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page