ReflexioDeveloper Docs
Menu
All

Connection & Authentication

Connect to Hosted Enterprise or a Local OSS server.

Connection & Authentication

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

Hosted Enterprise

Hosted Enterprise

API key authentication and the hosted endpoint at https://www.reflexio.ai require a Reflexio Enterprise account.

Hosted Enterprise registration is open — no invitation required. Create an account with email and password (then verify your email) or sign up with Google or GitHub. 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 and GitHub cannot be used for an invited address. Team membership does not grant access to Reflexio's fleet-wide operator administration, even when the organization's original login is an operator account.

API key creation on the Account page in the Reflexio Enterprise web portal

import reflexio

# export REFLEXIO_API_KEY="your-api-key"
client = reflexio.ReflexioClient()

response = client.whoami()
print("Client connected to Hosted Enterprise")
curl -X GET "${REFLEXIO_URL:-https://www.reflexio.ai}/api/whoami" \
  -H "User-Agent: my-agent-reflexio" \
  -H "Authorization: Bearer $REFLEXIO_API_KEY"

Direct API Key

import reflexio

client = reflexio.ReflexioClient(api_key="your-api-key")

Local OSS

Direct URL

import reflexio

client = reflexio.ReflexioClient(url_endpoint="http://localhost:8081")

response = client.get_config()
print("Client connected to local server")
curl -X GET "http://localhost:8081/api/get_config" \
	  -H "User-Agent: my-agent-reflexio"

Environment Variable

import reflexio

# export REFLEXIO_URL="http://localhost:8081"
client = reflexio.ReflexioClient()

response = client.get_config()
print("Client connected via environment variable")
curl -X GET "${REFLEXIO_URL:-http://localhost:8081}/api/get_config" \
	  -H "User-Agent: my-agent-reflexio"