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

# ModusOptions

> Constructor options for Modus, AsyncModus, and ModusManagement.

### ModusOptions

```python
class ModusOptions
```

Bases: `TypedDict`

Constructor options for `Modus`, `AsyncModus`, and `ModusManagement`.

Pass these as keyword arguments to the client constructor — you rarely construct this TypedDict yourself.

Keys:

* `api_key` — Modus API key; falls back to `MODUS_API_KEY`

* `base_url` — API origin without a path suffix (default `https://api.getmodus.com`)

* `timeout` — seconds or `httpx.Timeout` (default 5s connect / 300s read)

* `max_retries` — retries on 429/5xx (default 2)

* `agent_host` / `organization_id` / `base_urls` — staging/local escape hatches; usually omit

Example:

```
client = modus.Modus(
    api_key="modus_xxx",
    base_url="https://api.getmodus.com",
    timeout=300.0,
    max_retries=2,
)
```

#### api\_key

```python
api_key: str
```

#### base\_url

```python
base_url: str
```

#### agent\_host

```python
agent_host: str
```

#### organization\_id

```python
organization_id: str
```

#### base\_urls

```python
base_urls: Mapping[str, str]
```

#### timeout

```python
timeout: float | Timeout
```

#### max\_retries

```python
max_retries: int
```