{
  "type": "object",
  "description": "Request body for atomic tag promotion. Moves a mutable tag pointer\n(`stable`, `canary`, ...) from one immutable version to another in a\nsingle transaction. Distinct from a generic update so the action is\nauditable as a promotion rather than an arbitrary edit.",
  "required": [
    "from_version",
    "to_version",
    "tag"
  ],
  "properties": {
    "from_version": {
      "type": "string",
      "description": "Version that currently holds the tag. Must match the current pointer\nor the request fails so promotions are linearizable against caller\nstate."
    },
    "tag": {
      "type": "string",
      "description": "Tag being promoted. Must match the catalog tag regex."
    },
    "to_version": {
      "type": "string",
      "description": "Version that should hold the tag after the promotion completes."
    }
  },
  "additionalProperties": false
}