Ingest API overview
Base URL: https://ingest.amlexia.com
Public endpoints used by SDKs and custom integrations.
| Method | Path | Auth |
|---|---|---|
GET | /health | None |
POST | /v1/events | sdk_key in JSON body |
POST | /v1/traces | sdk_key in JSON body |
POST | /v1/otel/traces | sdk_key + OTEL payload |
Health check
bash
curl https://ingest.amlexia.com/healthAuthentication
Include your project SDK key in the JSON body:
json
{
"sdk_key": "am_...",
"events": []
}Invalid keys return 401.
Rate limits
Ingest is rate-limited per key. If you exceed limits, you may receive 429 — SDKs retry with backoff.
Prefer an SDK
| SDK | Install |
|---|---|
| Node | @amlexiahq/node |
| Python | amlexia |
| Go | github.com/amlexiahq/amlexia-go |
| Ruby | gem install amlexia |
SDKs handle batching, retries, cost enrichment, sampling, and shutdown flush. See Feature parity.
- Events API
- Traces & OTEL
- Dashboard API (Clerk JWT — not for ingest)