CostRunPriceQuery

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vertesiahq/json-schema/vertesiahq-cost-run-price-query-schema.json",
  "title": "CostRunPriceQuery",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vertesiahq-costs-api-openapi.yml#/components/schemas/CostRunPriceQuery",
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "description": "Interaction execution run ID"
    },
    "agent_run_id": {
      "type": "string",
      "description": "Agent run ID"
    },
    "workflow_id": {
      "type": "string",
      "description": "Workflow ID, when known"
    },
    "workflow_run_id": {
      "type": "string",
      "description": "Temporal workflow run ID, when known"
    },
    "from": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional lower bound for audit events"
    },
    "to": {
      "type": [
        "string",
        "number"
      ],
      "description": "Optional upper bound for audit events"
    },
    "pricing_source": {
      "type": "string",
      "enum": [
        "list",
        "historical"
      ],
      "description": "Pricing source. Defaults to historical effective prices for run pricing."
    },
    "include_comparison_pricing": {
      "type": "boolean",
      "description": "Include the full pricing catalog for cross-model comparison. Defaults to false."
    },
    "project_id": {
      "type": "string",
      "description": "Project filter; server fills current project by default"
    },
    "account_id": {
      "type": "string",
      "description": "Account filter; server fills current account"
    },
    "scope": {
      "type": "string",
      "enum": [
        "project",
        "org"
      ],
      "description": "Scope: 'project' (default, current project) or 'org'"
    }
  },
  "additionalProperties": false
}