{"schema_version":"kai-ingest-1","endpoint":"POST /api/kaios/ingest","discovery":"GET /api/kaios/ingest","auth":{"scheme":"Bearer","header":"Authorization","env_var":"KAIOS_INGEST_TOKEN","notes":"When KAIOS_INGEST_TOKEN is unset the endpoint returns 503 \"Ingestion disabled\". When set, every request must present a matching Bearer token; mismatches return 401."},"secret_header":{"name":"Authorization","format":"Bearer <KAIOS_INGEST_TOKEN>","example":"Authorization: Bearer 5a3…c2e"},"content_type":"application/json","required_fields":{"agent_id":{"type":"string","description":"Stable unique identifier for the deploying agent (e.g. \"agent-7c3a\")."},"status_code":{"type":"integer","description":"Partner-side numeric health/status code (0 = healthy)."},"uptime_seconds":{"type":"integer","description":"Partner-reported uptime since last restart, in seconds (>= 0)."},"last_seen_at":{"type":"string","description":"ISO-8601 timestamp of the agent reading."}},"responses":{"202":{"ok":true,"accepted_at":"ISO-8601 string","replay_id":"string","id":"integer"},"400":{"ok":false,"errors":["string"]},"401":{"ok":false,"error":"Unauthorized"},"503":{"ok":false,"error":"Ingestion disabled: KAIOS_INGEST_TOKEN not configured"}},"example_envelope":{"agent_id":"agent-7c3a","status_code":0,"uptime_seconds":43200,"last_seen_at":"2026-07-24T12:00:00Z"},"persistence":{"table":"kaios_telemetry","landing_page_overlay":"/kaios (live status panel — re-renders per request)"}}