> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parable.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK

> Authenticate and call the Workspace API from Python.

The Python client is `parable_web_api_sdk`. It covers the endpoints in the
[Workspace API reference](/protocols/http/workspace).

## Access

Distribution is not public yet. Contact your Parable representative for access.

## Import and authenticate

Create a client with your Workspace API token.

```python theme={null}
import os

from parable_web_api_sdk import ClientConfig, WebApiSDK

token = os.environ["PARABLE_API_TOKEN"]

sdk = WebApiSDK(
    ClientConfig(
        base_url="https://api.parable.work",
        auth_token=token,
    )
)
```

The client sends `Authorization: Bearer ...` on every call.

## Query Workspace data

Use the Python Flight SQL client alongside the Workspace API SDK when you need
table data rather than control-plane resources. The
[SQL SDK guide](/protocols/sql/query-with-sdks) shows how to execute a query and
read its Arrow result. The [SQL primer](/protocols/sql) defines the shared
catalog and pool model.

## Read

Read the current member, then the Provider connections configured in the
Workspace:

```python theme={null}
me = sdk.users.me()
print(me.name, me.email)

connections = sdk.vendors.tenant_connector_instances()
for connection in connections:
    print(connection.name, connection.connection_status)
```

## Update

Enable a tap. Replace the ID with one from the Workspace. List taps with
`sdk.tenant_connector_taps.tenant_connector_taps()`.

```python theme={null}
from parable_types_web_api import UpdateTenantConnectorTapInput

tap = sdk.tenant_connector_taps.update_tenant_connector_tap(
    "018f2a3b-9c4d-7e5f-8a6b-1c2d3e4f5a6b",
    UpdateTenantConnectorTapInput(enabled=True),
)
print(tap.id, tap.enabled)
```

Omitted fields are left unchanged. To disable the tap, pass
`UpdateTenantConnectorTapInput(enabled=False)`.

<Tip>
  Groups in the [Workspace API reference](/protocols/http/workspace) are
  namespaces such as `sdk.users` and `sdk.vendors`. Operations are snake\_case
  methods such as `me` and `tenant_connector_instances`.
</Tip>