{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/zespan/main/json-schema/zespan-post-v1-prompts-name-versions-version-gate-request-schema.json",
  "title": "PostV1PromptsNameVersionsVersionGateRequest",
  "x-generated": "2026-10-19",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/zespan-openapi-generated.yml#/components/schemas/PostV1PromptsNameVersionsVersionGateRequest",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The prompt's name."
    },
    "version": {
      "type": "number",
      "description": "The candidate prompt version number to gate."
    },
    "dataset-run-id": {
      "type": "string",
      "description": "The dataset run — with the candidate version's traces already linked — to score and compare."
    },
    "evaluator-id": {
      "type": "string",
      "description": "The evaluator to use as the judge for both the candidate and baseline runs."
    },
    "baseline-run-id": {
      "type": "string",
      "description": "A specific dataset run to compare against. Omit this and `--baseline-label` both to default to the run tied to whatever currently holds the `production` label."
    },
    "baseline-label": {
      "type": "string",
      "description": "Compare against the run tied to this label instead of `production` (e.g. `staging`)."
    },
    "connection-id": {
      "type": "string",
      "description": "Pin scoring to a specific project LLM connection (BYOK) instead of the project default."
    },
    "regression-run-id": {
      "type": "string",
      "description": "Advanced: opt into a separate, optional fourth signal — the regression resolution rate. Pass the ID of a dataset run that has replay results from the regression-check flow."
    }
  },
  "required": [
    "name",
    "version",
    "dataset-run-id",
    "evaluator-id"
  ]
}