POST /api/govern/probe/telemetry

Endpoint

POST https://api.govern.archetypal.ai/api/govern/probe/telemetry

The Probe calls this endpoint automatically. You do not need to call it manually. This reference documents the payload format for debugging and custom integrations.

Authentication

Authorization: Bearer gvn_live_xxxxxxxxxxxx
X-Govern-Org-Id: org_xxxxxxxxxxxx

Request body

{
  "probe_id": "probe-production-1",
  "org_id": "org_xxxx",
  "batch_id": "batch_01HXYZ",
  "timestamp": "2026-04-12T14:23:05.000Z",
  "events": [
    {
      "event_id": "evt_01HXYZABC",
      "probe_id": "probe-production-1",
      "timestamp": "2026-04-12T14:23:01.432Z",
      "model": "claude-sonnet-4-20250514",
      "provider": "anthropic",
      "request_id": "req_xxxx",
      "latency_ms": 2134,
      "input_tokens": 847,
      "output_tokens": 312,
      "finish_reason": "end_turn",
      "http_status": 200,
      "scores": {
        "security": {
          "score": 0.02,
          "components": {
            "pii": 0.01,
            "injection": 0.00,
            "credentials": 0.02
          },
          "action": "pass"
        },
        "bias": {
          "score": 0.01,
          "components": {
            "gender": 0.01,
            "racial": 0.00,
            "age": 0.00
          },
          "action": "pass"
        },
        "accuracy": {
          "score": 0.91,
          "components": {
            "hallucination": 0.08,
            "grounding": 0.94
          },
          "action": "pass"
        },
        "drift": {
          "score": 0.04,
          "baseline_established": true,
          "action": "pass"
        },
        "cost": {
          "score": 0.08,
          "input_tokens": 847,
          "output_tokens": 312,
          "estimated_usd": 0.0072,
          "budget_utilization": 0.08,
          "action": "pass"
        }
      },
      "overall_action": "pass",
      "flags": [],
      "metadata": {
        "environment": "production",
        "app_version": "2.1.0"
      }
    }
  ]
}

Response

Success (202 Accepted):

{
  "accepted": 1,
  "rejected": 0,
  "batch_id": "batch_01HXYZ",
  "processed_at": "2026-04-12T14:23:05.123Z"
}

Partial failure (202 Accepted):

{
  "accepted": 48,
  "rejected": 2,
  "batch_id": "batch_01HXYZ",
  "rejections": [
    { "event_id": "evt_01HABC", "reason": "duplicate_event_id" },
    { "event_id": "evt_01HDEF", "reason": "schema_validation_error" }
  ]
}

Auth failure (401):

{
  "error": "unauthorized",
  "message": "Invalid or expired API key"
}

Rate limits

Limit	Value
Requests per second	100
Events per batch	500
Payload size	5MB

The Probe’s default batch size of 50 events is well within these limits. For high-throughput deployments, increasing batch size reduces request overhead.