Client

Sync Client

from axonpush import AxonPush

client = AxonPush(
    api_key="ak_...",
    tenant_id="1",
    base_url="https://api.axonpush.xyz",
    timeout=30.0,  # optional, default 30s
)

# Use the client
event = client.events.publish(...)

# Close when done
client.close()

Context Manager

with AxonPush(api_key="ak_...", tenant_id="1", base_url="https://api.axonpush.xyz") as client:
    client.events.publish(...)
# Automatically closed

Async Client

from axonpush import AsyncAxonPush

async with AsyncAxonPush(
    api_key="ak_...",
    tenant_id="1",
    base_url="https://api.axonpush.xyz",
) as client:
    event = await client.events.publish(...)

Required for OpenAI Agents SDK integration and any async Python code.

Constructor Parameters

Parameter	Type	Required	Default	Description
api_key	str	Yes	—	Your AxonPush API key
tenant_id	str	Yes	—	Organization/tenant ID
base_url	str	Yes	—	API base URL
timeout	float	No	30.0	HTTP request timeout in seconds

Loading from Environment

import os
from axonpush import AxonPush

client = AxonPush(
    api_key=os.environ["AXONPUSH_API_KEY"],
    tenant_id=os.environ["AXONPUSH_TENANT_ID"],
    base_url=os.environ.get("AXONPUSH_BASE_URL", "https://api.axonpush.xyz"),
)