vercel · dimitropoulos · Jun 3, 2025 · Jun 5, 2025 · Jun 5, 2025 · Jun 5, 2025
@@ -210,6 +210,7 @@ type ProjectResponse struct {
 	ResourceConfig                       *ResourceConfigResponse     `json:"resourceConfig"`
 	NodeVersion                          string                      `json:"nodeVersion"`
 	Crons                                *ProjectCronsResponse       `json:"crons"`
+	RollingRelease                       *RollingRelease             `json:"rollingRelease"`
 }
 
 type ProjectCronsResponse struct {

@@ -0,0 +1,127 @@
+package client
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/hashicorp/terraform-plugin-log/tflog"
+)
+
+// RollingReleaseStage represents a stage in a rolling release
+type RollingReleaseStage struct {
+	TargetPercentage int  `json:"targetPercentage"`          // Required: 0-100
+	Duration         *int `json:"duration,omitempty"`        // Required for automatic advancement: 1-10000 minutes
+	RequireApproval  bool `json:"requireApproval,omitempty"` // Only in response for manual-approval type
+}
+
+// RollingRelease represents the rolling release configuration
+type RollingRelease struct {
+	Enabled         bool                  `json:"enabled"`         // Required
+	AdvancementType string                `json:"advancementType"` // Required when enabled=true: 'automatic' or 'manual-approval'
+	Stages          []RollingReleaseStage `json:"stages"`          // Required when enabled=true: 2-10 stages
+}
+
+type RollingReleaseInfo struct {
+	RollingRelease RollingRelease `json:"rollingRelease"`
+	ProjectID      string         `json:"projectId"`
+	TeamID         string         `json:"teamId"`
+}
+
+// GetRollingRelease returns the rolling release for a given project.
+func (c *Client) GetRollingRelease(ctx context.Context, projectID, teamID string) (RollingReleaseInfo, error) {
+	teamId := c.TeamID(teamID)
+	url := fmt.Sprintf("%s/v1/projects/%s/rolling-release/config?teamId=%s", c.baseURL, projectID, teamId)
+
+	var d RollingReleaseInfo
+	err := c.doRequest(clientRequest{
+		ctx:    ctx,
+		method: "GET",
+		url:    url,
+	}, &d)
+
+	if err != nil {
+		return RollingReleaseInfo{}, fmt.Errorf("error getting rolling-release: %w", err)
+	}
+
+	d.ProjectID = projectID
+	d.TeamID = teamId
+
+	return d, nil
+}
+
+// UpdateRollingReleaseRequest defines the information that needs to be passed to Vercel in order to
+// update a rolling release.
+type UpdateRollingReleaseRequest struct {
+	RollingRelease RollingRelease `json:"rollingRelease"`
+	ProjectID      string         `json:"projectId"`
+	TeamID         string         `json:"teamId"`
+}
+
+// UpdateRollingRelease will update an existing rolling release to the latest information.
+func (c *Client) UpdateRollingRelease(ctx context.Context, request UpdateRollingReleaseRequest) (RollingReleaseInfo, error) {
+	request.TeamID = c.TeamID(request.TeamID)
+	if request.RollingRelease.Enabled {
+		enableRequest := map[string]any{
+			"enabled":         true,
+			"advancementType": request.RollingRelease.AdvancementType,
+			"stages":          request.RollingRelease.Stages,
+		}
+
+		var result RollingReleaseInfo
+		err := c.doRequest(clientRequest{
+			ctx:    ctx,
+			method: "PATCH",
+			url:    fmt.Sprintf("%s/v1/projects/%s/rolling-release/config?teamId=%s", c.baseURL, request.ProjectID, request.TeamID),
+			body:   string(mustMarshal(enableRequest)),
+		}, &result)
+		if err != nil {
+			return RollingReleaseInfo{}, fmt.Errorf("error enabling rolling release: %w", err)
+		}
+
+		result.ProjectID = request.ProjectID
+		result.TeamID = request.TeamID
+		tflog.Info(ctx, "enabled rolling release", map[string]any{
+			"response": result,
+			"request":  request,
+		})
+		return result, nil
+	} else {
+		// For disabling, just send the request as is
+		disabledRequest := UpdateRollingReleaseRequest{
+			RollingRelease: RollingRelease{
+				Enabled:         false,
+				AdvancementType: "",
+				Stages:          []RollingReleaseStage{},
+			},
+		}
+
+		var result RollingReleaseInfo
+		err := c.doRequest(clientRequest{
+			ctx:    ctx,
+			method: "PATCH",
+			url:    fmt.Sprintf("%s/v1/projects/%s/rolling-release/config?teamId=%s", c.baseURL, request.ProjectID, request.TeamID),
+			body:   string(mustMarshal(disabledRequest.RollingRelease)),
+		}, &result)
+		if err != nil {
+			return RollingReleaseInfo{}, fmt.Errorf("error disabling rolling release: %w", err)
+		}
+
+		result.ProjectID = request.ProjectID
+		result.TeamID = request.TeamID
+
+		return result, nil
+	}
+}
+
+// DeleteRollingRelease will delete the rolling release for a given project.
+func (c *Client) DeleteRollingRelease(ctx context.Context, projectID, teamID string) error {
+	teamId := c.TeamID(teamID)
+	url := fmt.Sprintf("%s/v1/projects/%s/rolling-release/config?teamId=%s", c.baseURL, projectID, teamId)
+
+	err := c.doRequest(clientRequest{
+		ctx:    ctx,
+		method: "DELETE",
+		url:    url,
+	}, nil)
+	return err
+}
@@ -0,0 +1,56 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "vercel_project_rolling_release Data Source - terraform-provider-vercel"
+subcategory: ""
+description: |-
+  Data source for a Vercel project rolling release configuration.
+---
+
+# vercel_project_rolling_release (Data Source)
+
+Data source for a Vercel project rolling release configuration.
+
+## Example Usage
+
+```terraform
+data "vercel_project" "example" {
+	name = "example-project"
+}
+
+data "vercel_project_rolling_release" "example" {
+	project_id = data.vercel_project_rolling_release.example.id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `project_id` (String) The ID of the project.
+
+### Optional
+
+- `rolling_release` (Attributes) The rolling release configuration. (see [below for nested schema](#nestedatt--rolling_release))
+- `team_id` (String) The ID of the Vercel team.
+
+<a id="nestedatt--rolling_release"></a>
+### Nested Schema for `rolling_release`
+
+Read-Only:
+
+- `advancement_type` (String) The type of advancement between stages. Must be either 'automatic' or 'manual-approval'. Required when enabled is true.
+- `enabled` (Boolean) Whether rolling releases are enabled.
+- `stages` (Attributes List) The stages of the rolling release. Required when enabled is true. (see [below for nested schema](#nestedatt--rolling_release--stages))
+
+<a id="nestedatt--rolling_release--stages"></a>
+### Nested Schema for `rolling_release.stages`
+
+Optional:
+
+- `duration` (Number) The duration in minutes to wait before advancing to the next stage. Required for all stages except the final stage when using automatic advancement.
+
+Read-Only:
+
+- `require_approval` (Boolean) Whether approval is required before advancing to the next stage.
+- `target_percentage` (Number) The percentage of traffic to route to this stage.
@@ -0,0 +1,81 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "vercel_project_rolling_release Resource - terraform-provider-vercel"
+subcategory: ""
+description: |-
+  Manages rolling release configuration for a Vercel project.
+---
+
+# vercel_project_rolling_release (Resource)
+
+Manages rolling release configuration for a Vercel project.
+
+## Example Usage
+
+```terraform
+resource "vercel_project" "example" {
+	name = "example-project"
+	skew_protection = "12 hours"
+}
+
+resource "vercel_project_rolling_release" "example" {
+	project_id = vercel_project.example.id
+	rolling_release = {
+		enabled          = true
+		advancement_type = "manual-approval"
+		stages = [
+			{
+				require_approval  = true
+				target_percentage = 20
+			},
+			{
+				require_approval  = true
+				target_percentage = 50
+			},
+			{
+				require_approval  = true
+				target_percentage = 100
+			}
+		]
+	}
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `project_id` (String) The ID of the project.
+- `rolling_release` (Attributes) The rolling release configuration. (see [below for nested schema](#nestedatt--rolling_release))
+
+### Optional
+
+- `team_id` (String) The ID of the Vercel team.
+
+<a id="nestedatt--rolling_release"></a>
+### Nested Schema for `rolling_release`
+
+Required:
+
+- `enabled` (Boolean) Whether rolling releases are enabled.
+
+Optional:
+
+- `advancement_type` (String) The type of advancement between stages. Must be either 'automatic' or 'manual-approval'. Required when enabled is true.
+- `stages` (Attributes List) The stages of the rolling release. Required when enabled is true. (see [below for nested schema](#nestedatt--rolling_release--stages))
+
+<a id="nestedatt--rolling_release--stages"></a>
+### Nested Schema for `rolling_release.stages`
+
+Required:
+
+- `target_percentage` (Number) The percentage of traffic to route to this stage.
+
+Optional:
+
+- `duration` (Number) The duration in minutes to wait before advancing to the next stage. Required for non-last stages when advancement_type is 'automatic'.
+
+Read-Only:
+
+- `require_approval` (Boolean) Whether approval is required before advancing to the next stage.
@@ -0,0 +1,7 @@
+data "vercel_project" "example" {
+	name = "example-project"
+}
+
+data "vercel_project_rolling_release" "example" {
+	project_id = data.vercel_project_rolling_release.example.id
+}
@@ -0,0 +1,26 @@
+resource "vercel_project" "example" {
+	name = "example-project"
+	skew_protection = "12 hours"
+}
+
+resource "vercel_project_rolling_release" "example" {
+	project_id = vercel_project.example.id
+	rolling_release = {
+		enabled          = true
+		advancement_type = "manual-approval"
+		stages = [
+			{
+				require_approval  = true
+				target_percentage = 20
+			},
+			{
+				require_approval  = true
+				target_percentage = 50
+			},
+			{
+				require_approval  = true
+				target_percentage = 100
+			}
+		]
+	}
+}