Python

import httpx

class MaelClient:
    def __init__(self, base_url: str = "https://api.mael.in"):
        self._base_url = base_url
        self._access_token: str | None = None
        self._client = httpx.Client(base_url=base_url, timeout=30.0)

    def login(self, email: str, password: str) -> None:
        resp = self._client.post(
            "/api/v1/auth/login",
            json={"email": email, "password": password},
        )
        resp.raise_for_status()
        self._access_token = resp.json()["access_token"]

    def _auth_headers(self) -> dict[str, str]:
        if not self._access_token:
            raise RuntimeError("call login() first")
        return {"Authorization": f"Bearer {self._access_token}"}

    def trigger_workflow(self, workflow_id: str, **inputs: object) -> dict:
        resp = self._client.post(
            f"/api/v1/workflows/{workflow_id}/trigger",
            json={"inputs": inputs},
            headers=self._auth_headers(),
        )
        resp.raise_for_status()
        return resp.json()

    def get_run(self, run_id: str) -> dict:
        resp = self._client.get(
            f"/api/v1/workflows/runs/{run_id}",
            headers=self._auth_headers(),
        )
        resp.raise_for_status()
        return resp.json()

client = MaelClient()
client.login("you@example.com", "...")

run = client.trigger_workflow(
    "keyword-gap-analysis",
    domain_id="...",
    seed_keywords=["migraine treatment", "chronic headache"],
)
print(run["run_id"])