API Reference

The Trakr ingest API receives run and LLM call events from the SDK. All requests require a valid API key.

For session-authenticated read routes (runs, workflows), see the Dashboard API.

Base URL

https://app.trakr.run

Authentication

Include your API key in the Authorization header:

Authorization: Bearer tk_live_...

Ingest endpoint

POST /api/ingest
Content-Type: application/json

Accepts batched events from the SDK: run started, run ended, LLM calls, and tool use events.

Example payload

{
  "events": [
    {
      "type": "run_started",
      "runId": "run_abc123",
      "workflowName": "invoice-extractor",
      "timestamp": "2026-05-20T12:00:00.000Z"
    },
    {
      "type": "llm_call",
      "runId": "run_abc123",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "inputTokens": 1200,
      "outputTokens": 450,
      "latencyMs": 890,
      "timestamp": "2026-05-20T12:00:01.000Z"
    }
  ]
}

Health check

GET /api/health

Returns 200 OK when the dashboard is operational. Used for uptime monitoring.