openapi: 3.1.0
info:
  title: iAgentLog API (Shipping Q2-Q3 2026)
  description: |
    iAgentLog is decision-native observability for autonomous agents. Shipping Q2-Q3 2026.
    Every log entry captures the action, the reasoning, and the counterparties involved.
  version: v1-preview
  contact: {name: iJarvis LLC, email: hello@iagentlog.com, url: https://ijarvis.ai}
  license: {name: Proprietary, url: https://iagentlog.com/terms}
servers:
  - url: https://api.iagentlog.com/v1
    description: Planned production API (Q2-Q3 2026)
security: [{bearerAuth: []}]
components:
  securitySchemes:
    bearerAuth: {type: http, scheme: bearer, bearerFormat: API-Key}
paths:
  /status:
    get: {summary: Service health, responses: {'200': {description: healthy}}}
  /decisions:
    post:
      summary: Record an agent decision trace
      responses: {'202': {description: Accepted}}
  /decisions/{agentId}:
    get:
      summary: Read back decision traces for an agent
      parameters: [{name: agentId, in: path, required: true, schema: {type: string}}]
      responses: {'200': {description: Trace list}}
  /anomalies/{agentId}:
    get:
      summary: Detected anomalies against agent behavior baseline
      parameters: [{name: agentId, in: path, required: true, schema: {type: string}}]
      responses: {'200': {description: Anomaly list}}
  /baselines/{agentId}:
    get:
      summary: Learned behavior baseline for an agent
      parameters: [{name: agentId, in: path, required: true, schema: {type: string}}]
      responses: {'200': {description: Baseline summary}}
