Connection & Authentication

Emend has two public connection modes: Hosted Enterprise at https://www.emend.online and Local OSS at http://localhost:8081. For constructor details, see the Client Initialization Reference.

Hosted Enterprise

Hosted Enterprise registration is open — no invitation required. Create an account with email and password (then verify your email) or sign up with Google. Then create your first API key from the Account page in the web portal — new accounts do not come with one. API keys are shown only once at creation time, so store the value securely; afterward the portal displays only the saved prefix, which you use to identify and delete old keys.

An organization can also invite additional email/password logins from the Team access section of the Account page. Every accepted team member enters the same organization and therefore shares its data, configuration, billing, and API keys. Team logins are password-only in this release; Google cannot be used for an invited address. Team membership does not grant access to Emend’s fleet-wide operator administration, even when the organization’s original login is an operator account.

Environment Variable (Recommended)

import emend # export EMEND_API_KEY="your-api-key"client = emend.EmendClient() response = client.whoami()print("Client connected to Hosted Enterprise")

Direct API Key

import emend client = emend.EmendClient(api_key="your-api-key")

Local OSS

Direct URL

import emend client = emend.EmendClient(url_endpoint="http://localhost:8081") response = client.get_config()print("Client connected to local server")

Environment Variable

import emend # export EMEND_URL="http://localhost:8081"client = emend.EmendClient() response = client.get_config()print("Client connected via environment variable")