GetProjectRollingRelease

August 10, 2026 ยท View on GitHub

Project-level rolling release configuration that defines how deployments should be gradually rolled out

Example Usage

import { GetProjectRollingRelease } from "@vercel/sdk/models/getprojectprojectsbuildmachinetype.js";

let value: GetProjectRollingRelease = {
  target: "production",
  stages: [
    {
      targetPercentage: 25,
      requireApproval: false,
      duration: 600,
      linearShift: false,
    },
  ],
  canaryResponseHeader: false,
  gate: {
    enabled: true,
    checks: [],
    failureThreshold: 3,
    windowSize: 5,
    action: "pause",
    dryRun: true,
  },
};

Fields

FieldTypeRequiredDescriptionExample
targetstring:heavy_check_mark:The environment that the release targets, currently only supports production. Adding in case we want to configure with alias groups or custom environments.production
stagesmodels.GetProjectStages[]:heavy_minus_sign:An array of all the stages required during a deployment release. Each stage defines a target percentage and advancement rules. The final stage must always have targetPercentage: 100.
canaryResponseHeaderboolean:heavy_minus_sign:Whether the request served by a canary deployment should return a header indicating a canary was served. Defaults to false when omitted.false
gatemodels.GetProjectGate:heavy_minus_sign:Automated gating configuration. Omitted (the default) means no gating is configured, which is equivalent to enabled: false.