SDKs

Elmo publishes typed clients for the REST API, generated from the same OpenAPI spec the API serves, so a new endpoint reaches them without anyone writing it by hand.

Both read an API key from ELMO_API_KEY and the address to call from ELMO_BASE_URL. The base URL has no default you can rely on — every instance serves the API on its own address — so always set it. On cloud that is https://app.elmohq.com/api/v1; a self-hosted instance uses its own APP_URL followed by /api/v1.

Every deployment also shows both snippets at Settings → API, with its own base URL filled in.

Pass apiKey and baseURL to the constructor instead of setting the environment variables, for example to talk to two instances from one process. Node.js 20.19 or later is required.

AsyncElmo has the same calls for asyncio. Pass api_key and base_url to the constructor instead of setting the environment variables. Python 3.10 or later is required.

Each SDK is versioned on its own, by what changed in the API rather than by Elmo's release number: a removed or changed endpoint is a major version, a new one a minor version. Each repository's README covers pagination, errors, retries, and timeouts in full.