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

# Python SDK

> Install the Python client, authenticate, and call the API.

The Python client is `parable_web_api_sdk`. It covers every endpoint in
the [API Reference](/api-reference/overview).

<Info>
  Your Parable representative will confirm registry access if the package
  is not public yet.
</Info>

## Install

```bash theme={null}
pip install parable_web_api_sdk parable_types_web_api
```

## Import and authenticate

Create a client with your workspace API token. See
[Authentication](/getting-started/authentication) if you do not have one.

```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.askparable.com",
        auth_token=token,
    )
)
```

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

## Read

Who you are, then the connectors configured in your workspace:

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

connectors = sdk.vendors.tenant_connector_instances()
for connector in connectors:
    print(connector.name, connector.connection_status)
```

## Update

Enable a tap. Replace the id with one from your 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>
  This SDK maps directly to API names. Groups in the
  [API Reference](/api-reference/overview) are namespaces
  (`sdk.users`, `sdk.vendors`); operation names are snake\_case methods
  (`me`, `tenant_connector_instances`). If an endpoint is in that spec,
  it is on this client.
</Tip>