ModusManagement

from modus.management import ModusManagement

mgmt = ModusManagement(api_key="modus_xxx")
scope = mgmt.scopes.create(name="Analyst", model="gpt-4o")
mgmt.scopes.deploy(scope.id)

​

ModusManagement

class ModusManagement(api_key: str | None = None, *, base_url: str | None = None, timeout: float | Timeout | None = None, max_retries: int | None = None)

• Parameters:
  • api_key – Your Modus API key (requires scopes:write + workflows:write scopes). Falls back to MODUS_API_KEY env var.
  • base_url – API origin without a path suffix (default https://api.getmodus.com).
  • timeout – Request timeout as seconds or httpx.Timeout. Default is 5s connect and 300s read.
  • max_retries – Retries on 429/5xx (default 2).

​

close()

close() → None

​

AsyncModusManagement

class AsyncModusManagement(api_key: str | None = None, *, base_url: str | None = None, timeout: float | Timeout | None = None, max_retries: int | None = None)

• Parameters:
  • api_key – Modus API key with write scopes. Falls back to MODUS_API_KEY.
  • base_url – API origin without a path suffix (default https://api.getmodus.com).
  • timeout – Request timeout as seconds or httpx.Timeout. Default is 5s connect and 300s read.
  • max_retries – Retries on 429/5xx (default 2).

​

aclose()

async aclose() → None