{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vertesiahq/json-schema/vertesiahq-audit-usage-response-schema.json",
  "title": "AuditUsageResponse",
  "description": "UTC usage trends. Period-wide distinct users are not sums of bucket populations. No user identities are returned.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vertesiahq-audit-trail-api-openapi.yml#/components/schemas/AuditUsageResponse",
  "type": "object",
  "properties": {
    "period": {
      "$ref": "#/$defs/AuditAdoptionPeriod"
    },
    "resolution": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ]
    },
    "totals": {
      "$ref": "#/$defs/AuditUsageCounts"
    },
    "timeline": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AuditUsageBucket"
      }
    }
  },
  "required": [
    "period",
    "resolution",
    "totals",
    "timeline"
  ],
  "additionalProperties": false,
  "$defs": {
    "AuditAdoptionPeriod": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "AuditUsageBucket": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        },
        "partial": {
          "type": "boolean"
        },
        "counts": {
          "$ref": "#/$defs/AuditUsageCounts"
        }
      },
      "required": [
        "from",
        "to",
        "partial",
        "counts"
      ],
      "additionalProperties": false
    },
    "AuditUsageCounts": {
      "type": "object",
      "properties": {
        "active_users": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "agent_runs": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "All audited run creations and marked restarts, including automated runs."
        },
        "user_agent_runs": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Run operations initiated directly by authenticated users, including OAuth/MCP."
        },
        "automated_agent_runs": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Other run operations, including schedules, delegated agents, services and API keys."
        },
        "agent_users": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Distinct identifiable user initiators or owners of run operations, including scheduled and delegated runs."
        },
        "direct_calls": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "direct_call_users": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "content_objects": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "user_content_objects": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "other_content_objects": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "active_users",
        "agent_runs",
        "user_agent_runs",
        "automated_agent_runs",
        "agent_users",
        "direct_calls",
        "direct_call_users",
        "content_objects",
        "user_content_objects",
        "other_content_objects"
      ],
      "additionalProperties": false,
      "description": "Direct productive users, run initiators/owners, all run operations and standalone inference audit events."
    }
  }
}