API Overview

The Metriva API provides HTTPS endpoints for submitting event data and operational telemetry from applications and services. Requests follow standard REST semantics and are designed to be safely retried by clients.

Authentication

API access is authenticated using per-project tokens. Tokens must be provided via the Authorization header on each request.

Endpoints

POST /api/v1/events
POST /api/v1/batch
GET  /health
  

The /events endpoint accepts individual event payloads, while /batch allows submitting multiple events in a single request to reduce network overhead.

Delivery guarantees

Metriva processes events on a best-effort basis with at-least-once delivery semantics. Clients are encouraged to implement idempotency and retry logic when submitting data.

Rate limits

Requests may be rate-limited to protect platform stability. Limits depend on the selected plan and are documented in response headers.