vercel · brookemosby · Jul 24, 2025 · Jun 3, 2025 · Jun 5, 2025 · Jun 5, 2025
@@ -0,0 +1,137 @@
+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
+}
+
+// CreateRollingReleaseRequest defines the information that needs to be passed to Vercel in order to
+// create a new rolling release.
+type CreateRollingReleaseRequest struct {
+	RollingRelease RollingRelease `json:"rollingRelease"`
+	ProjectID      string         `json:"projectId"`
+	TeamID         string         `json:"teamId"`
+}
+
+// CreateRollingRelease will create a new rolling release for a given project.
+func (c *Client) CreateRollingRelease(ctx context.Context, request CreateRollingReleaseRequest) (RollingReleaseInfo, error) {
+	request.TeamID = c.TeamID(request.TeamID)
+	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, "created rolling release", map[string]any{
+		"response": result,
+		"request":  request,
+	})
+	return result, 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)
+	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, "updated rolling release", map[string]any{
+		"response": result,
+		"request":  request,
+	})
+	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,47 @@
+---
+# 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.example.id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `project_id` (String) The ID of the project.
+
+### Optional
+
+- `team_id` (String) The ID of the Vercel team.
+
+### Read-Only
+
+- `advancement_type` (String) The type of advancement for the rolling release. Either 'automatic' or 'manual-approval'.
+- `stages` (Attributes List) The stages for the rolling release configuration. (see [below for nested schema](#nestedatt--stages))
+
+<a id="nestedatt--stages"></a>
+### Nested Schema for `stages`
+
+Read-Only:
+
+- `duration` (Number) The duration in minutes to wait before advancing to the next stage. Present for automatic advancement type.
+- `target_percentage` (Number) The percentage of traffic to route to this stage.
@@ -0,0 +1,57 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "vercel_project_rolling_release Resource - terraform-provider-vercel"
+subcategory: ""
+description: |-
+  Resource for a Vercel project rolling release configuration.
+---
+
+# vercel_project_rolling_release (Resource)
+
+Resource for a Vercel project rolling release configuration.
+
+## 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
+	advancement_type = "manual-approval"
+	stages = [
+		{
+			target_percentage = 20
+		},
+		{
+			target_percentage = 50
+		}
+	]
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `advancement_type` (String) The type of advancement for the rolling release. Must be either 'automatic' or 'manual-approval'.
+- `project_id` (String) The ID of the project.
+- `stages` (Attributes List) The stages for the rolling release configuration. The last stage must have target_percentage = 100. (see [below for nested schema](#nestedatt--stages))
+
+### Optional
+
+- `team_id` (String) The ID of the Vercel team.
+
+<a id="nestedatt--stages"></a>
+### Nested Schema for `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 automatic advancement type.
@@ -0,0 +1,7 @@
+data "vercel_project" "example" {
+	name = "example-project"
+}
+
+data "vercel_project_rolling_release" "example" {
+	project_id = data.vercel_project.example.id
+}
@@ -0,0 +1,17 @@
+resource "vercel_project" "example" {
+	name = "example-project"
+	skew_protection = "12 hours"
+}
+
+resource "vercel_project_rolling_release" "example" {
+	project_id = vercel_project.example.id
+	advancement_type = "manual-approval"
+	stages = [
+		{
+			target_percentage = 20
+		},
+		{
+			target_percentage = 50
+		}
+	]
+}