API Reference

All endpoints are served from:

https://api.eldrstream.com

Authentication

EldrStream uses two authentication mechanisms:

Mechanism	When to use	Format
API Key	Event ingestion (`POST /v1/ingest`)	`Authorization: Bearer eldr_sk_...`
JWT	All management endpoints	`Authorization: Bearer <jwt>`

Section	Endpoints
Authentication	Login
Ingestion	Send events
Events	Query event history and delivery state
Webhooks	Configure delivery endpoints
Replays	Re-deliver events
Account	Create, upgrade, and delete your account
API Keys	Retrieve and rotate your API key
Dashboard	Real-time event stream (SSE)

Code	Meaning
`200 OK`	Request succeeded
`201 Created`	Resource created successfully
`202 Accepted`	Request accepted; processing is asynchronous
`204 No Content`	Success with no response body
`400 Bad Request`	Invalid request parameters — see `message` field
`401 Unauthorized`	Missing, invalid, or expired credentials
`402 Payment Required`	Payment action required
`403 Forbidden`	Authenticated but not authorised for this resource
`404 Not Found`	Resource does not exist in your account
`503 Service Unavailable`	Temporary service issue — safe to retry