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

# Connection

> Manages authenticated connections to the Fiddler platform.

Manages authenticated connections to the Fiddler platform.

The Connection class handles all aspects of connecting to and communicating
with the Fiddler platform, including authentication, HTTP client management,
server version compatibility checking, and organization context management.

This class provides the foundation for all API interactions with Fiddler,
managing connection parameters, authentication tokens, and ensuring proper
communication protocols are established.

## Examples

Creating a basic connection:

```python theme={null}
connection = Connection(
    url="https://your-fiddler-instance.com",
    token="your-api-key"
)
```

Creating a connection with custom timeout and proxy:

```python theme={null}
connection = Connection(
    url="https://your-fiddler-instance.com",
    token="your-api-key",
    timeout=(5.0, 30.0),  # (connect_timeout, read_timeout)
    proxies={"https": "https://proxy.company.com:8080"}
)
```

Creating a connection without SSL verification:

```python theme={null}
connection = Connection(
    url="https://your-fiddler-instance.com",
    token="your-api-key",
    verify=False,  # Not recommended for production
    validate=False  # Skip version compatibility check
)
```

Initialize a connection to the Fiddler platform.

## Parameters

<ParamField path="url" type="str" required={true}>
  The base URL to your Fiddler platform instance
</ParamField>

<ParamField path="token" type="str" required={true}>
  API key obtained from the Fiddler UI Credentials tab
</ParamField>

<ParamField path="proxies" type="dict | None" required={false} default="None">
  Dictionary mapping protocol to proxy URL for HTTP requests
</ParamField>

<ParamField path="timeout" type="float | tuple[float, float] | None" required={false} default="None">
  HTTP request timeout settings (float or tuple of connect/read timeouts)
</ParamField>

<ParamField path="verify" type="bool" required={false} default="True">
  Whether to verify server's TLS certificate (default: True)
</ParamField>

<ParamField path="validate" type="bool" required={false} default="True">
  Whether to validate server/client version compatibility (default: True)
</ParamField>

## Raises

* **ValueError** – If url or token parameters are empty
* **IncompatibleClient** – If server version is incompatible with client version

## *property* client

Get the HTTP request client instance for API communication.

### Returns

<ResponseField type="RequestClient">
  Configured HTTP client with authentication headers,
  proxy settings, and timeout configurations.
</ResponseField>

## *property* server\_info

Get server information and metadata from the Fiddler platform.

### Returns

<ResponseField type="ServerInfo">
  Server information including version, organization details,
  and platform configuration.
</ResponseField>

## *property* server\_version

Get the semantic version of the connected Fiddler server.

### Returns

<ResponseField type="Version">
  Semantic version object representing the server version.
</ResponseField>

## *property* organization\_name

Get the name of the connected organization.

### Returns

<ResponseField type="str">
  Name of the organization associated with this connection.
</ResponseField>

## *property* organization\_id

Get the UUID of the connected organization.

### Returns

<ResponseField type="UUID">
  Unique identifier of the organization associated with this connection.
</ResponseField>