ModusOptions

​

ModusOptions

class ModusOptions

• 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

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

​

api_key

api_key: str

​

base_url

base_url: str

​

agent_host

agent_host: str

​

organization_id

organization_id: str

​

base_urls

base_urls: Mapping[str, str]

​

timeout

timeout: float | Timeout

​

max_retries

max_retries: int