HydraCore
API by router

Telemetry

Ingest Telemetry

Ingest LLM usage telemetry from a VPS agent.

Security:

  • mTLS: client cert must match instance
  • Idempotent: duplicate request_ids are silently skipped
  • Anti-replay: events older than 24h are rejected
  • Cost verification: server recalculates cost from pricing table

"I find your lack of faith disturbing." — Darth Vader (about agents that don't report their usage)

POST
/internal/v1/instances/{instance_id}/telemetry

Path Parameters

instance_idInstance Id
Formatuuid
eventsEvents
Items1 <= items <= 100

Response Body

curl -X POST "https://loading/internal/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/telemetry" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "estimated_tokens_in": 0,        "estimated_tokens_out": 0,        "event_ts": "2019-08-24T14:15:22Z",        "key_source": "string",        "model": "string",        "provider": "string",        "request_id": "string"      }    ]  }'
{
  "accepted": 0,
  "duplicates": 0,
  "errors": [],
  "rejected": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}