{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/roark/json-schema/roark-benchmark-target-schema.json",
  "title": "BenchmarkTarget",
  "description": "A model or stack with a published result on a benchmark suite",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/roark-benchmark-api-openapi.yml#/components/schemas/BenchmarkTarget",
  "type": "object",
  "properties": {
    "targetKey": {
      "type": "string",
      "description": "Stable identity of the model/stack across sweeps. Cite this, and pass it to the target endpoints."
    },
    "targetName": {
      "type": "string",
      "description": "Human-readable name of the model/stack."
    },
    "suite": {
      "type": "string"
    },
    "suiteVersion": {
      "type": "string"
    },
    "publicationId": {
      "type": "string",
      "format": "uuid",
      "description": "Id of this one sweep. Changes every time the target is re-published, so it is a render key, not an identity."
    },
    "iterations": {
      "type": "integer",
      "description": "Calls the sweep requested per condition."
    },
    "sampleCallCount": {
      "type": "integer",
      "description": "Executed calls that contributed at least one score to these numbers."
    },
    "publishedAt": {
      "type": "string",
      "description": "When this sweep was published (ISO-8601), i.e. data freshness."
    },
    "supersededAt": {
      "type": [
        "string",
        "null"
      ],
      "description": "When a later sweep replaced this one. Null means it is the current generation."
    },
    "isCurrent": {
      "type": "boolean",
      "description": "Whether these are the numbers Roark publishes for this target today."
    }
  },
  "required": [
    "targetKey",
    "targetName",
    "suite",
    "suiteVersion",
    "publicationId",
    "iterations",
    "sampleCallCount",
    "publishedAt",
    "supersededAt",
    "isCurrent"
  ]
}