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 the SDK
Use @amlexiahq/node or amlexia unless you need a custom language. SDKs handle batching, retries, and shutdown flush.