---
title: "Create or update gradual rollout strategy"
method: PUT
path: "/v1/teams/{teamId}/gradual-rollout-strategies"
tags: ["Rollout Strategies", "team"]
---

# Create or update gradual rollout strategy

`PUT /v1/teams/{teamId}/gradual-rollout-strategies`

## Request

- Base URL: `https://placeholder/v1`
- URL: `https://placeholder/v1/v1/teams/{teamId}/gradual-rollout-strategies`
- Auth: none required
- TypeScript: <https://skmtc.dev/northflank/apis/northflank-api/docs/v1/teams/:teamId/gradual-rollout-strategies/put.ts> (a function with typed inputs; its response is checked against the schema)

Creates or updates a gradual rollout strategy.

## Path parameters

- `teamId` string, required

## Request body

- object: Gradual rollout strategy specification
  - `name` string: Display name for the gradual rollout strategy
  - `type` 'canary', required: Type of the gradual rollout strategy
  - `options` object
    - `triggers` object: Conditions under which a new release will automatically initiate as a gradual rollout
      - `releaseFromTemplate` boolean, nullable: Automatically trigger the rollout strategy when a release is initiated from a template
      - `releaseFromReleaseFlow` boolean, nullable: Automatically trigger the rollout strategy when a release is initiated from a release flow
      - `releaseFromCD` boolean, nullable: Automatically trigger the rollout strategy when a release is initiated from a CD pipeline
      - `releaseFromUI` boolean, nullable: Automatically trigger the rollout strategy when a release is initiated from the UI
      - `releaseFromApi` boolean, nullable: Automatically trigger the rollout strategy when a release is initiated via the API
    - `blockDeploymentOnActiveRollout` boolean, nullable: When enabled, new deployments are blocked while a rollout is in progress
  - `details` object, required: Strategy-specific configuration details
    - `canaryStrategy` 'percentage' | 'header', required: Strategy used to split traffic between stable and canary deployments
    - `config` union, required: Configuration for the selected canary strategy
      - object: Configuration for the selected canary strategy
        - `canaryPercentage` integer, required: Percentage of traffic to route to the canary deployment
        - `stablePercentage` integer, required: Percentage of traffic to route to the stable deployment
      - object: Configuration for the selected canary strategy
        - `canaryHeader` object, required: Header configuration that will route traffic to the canary deployment
          - `headerName` string, required: HTTP header name used to identify requests that should be routed to the target deployment
          - `headerValue` string, required: HTTP header value that routes matching requests to the target deployment
        - `stableHeader` object, required: Header configuration that will route traffic to the stable deployment
          - `headerName` string, required: HTTP header name used to identify requests that should be routed to the target deployment
          - `headerValue` string, required: HTTP header value that routes matching requests to the target deployment

## Response `200`

Details about the created or updated project.

## Changes

- **2026-11-06** `503a425aa44f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/northflank/apis/northflank-api/changes/v1/teams/:teamId/gradual-rollout-strategies/put.md)

---

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