---
title: "Update the rolling release settings for the project"
method: PATCH
path: "/v1/projects/{idOrName}/rolling-release/config"
tags: ["rolling-release"]
---

# Update the rolling release settings for the project

`PATCH /v1/projects/{idOrName}/rolling-release/config`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/projects/{idOrName}/rolling-release/config`
- Auth: HTTP bearer

Update (or disable) Rolling Releases for a project. When disabling with the resolve-on-disable feature flag enabled, any active rolling release document is resolved using the disableRolloutAction parameter: "abort" to roll back (default), or "complete" to promote the canary to production. When enabling or updating config, changes only affect the next production deployment and do not alter a rollout that's already in-flight. Note: Enabling Rolling Releases automatically enables skew protection on the project with the default value if it wasn't configured already.

## Path parameters

- `idOrName` string, required: Project ID or project name (URL-encoded)

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

- union
  - object
    - `rollingRelease` unknown, required
  - object
    - `rollingRelease` object, nullable, required
      - `stages` object[], nullable
        - `duration` number: Duration in minutes for automatic advancement to the next stage
        - `linearShift` false | true: Whether to linearly shift traffic over the duration of this stage
        - `requireApproval` false | true: Whether or not this stage requires manual approval to proceed
        - `targetPercentage` number, required: The percentage of traffic to serve to the canary deployment (0-100)

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-01-22** `c12186034433`: 4 warning
  - added the new `false` enum value to the `oneOf[subschema #2]/rollingRelease/stages/items/linearShift` response property for the response status `200`
  - added the new `false` enum value to the `oneOf[subschema #2]/rollingRelease/stages/items/requireApproval` response property for the response status `200`
  - added the new `true` enum value to the `oneOf[subschema #2]/rollingRelease/stages/items/linearShift` response property for the response status `200`
  - added the new `true` enum value to the `oneOf[subschema #2]/rollingRelease/stages/items/requireApproval` response property for the response status `200`
- **2025-10-09** `50caddad4ae7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/projects/:idOrName/rolling-release/config/patch.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)