MetriclyDocs

Ingestion API

POST /api/ingest

Report a single event. A GET on the same path returns a small usage/health payload, and OPTIONS is handled for CORS preflight.

Authentication

Send your project ingest key using any one of:

  • X-Metricly-Key: mtr_your_key header (recommended)
  • Authorization: Bearer mtr_your_key
  • ?key=mtr_your_key query parameter

CORS is open (*) so browser apps can report directly. The key only permits writing events into its project — it grants no read access and can't touch any other resource.

Limits

  • Request bodies are capped at 512KB per event; larger payloads return 413.
  • Free-form objects (tags, extra, user) are trimmed defensively so a single event can't store megabytes.

Next: see the event payload reference and code examples.