Release pipelines (beta)

Create a release pipeline

POST
/api/v2/projects/{projectKey}/release-pipelines

Creates a new release pipeline.

The first release pipeline you create is automatically set as the default release pipeline for your project. To change the default release pipeline, use the Update project API to set the defaultReleasePipelineKey.

You can create up to 20 release pipelines per project.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

projectKey*string

The project key

Formatstring

Request Body

application/json

description?string

The release pipeline description

key*string

The unique identifier of this release pipeline

name*string

The name of the release pipeline

phases*array<>

A logical grouping of one or more environments that share attributes for rolling out changes

tags?array<string>

A list of tags for this release pipeline

isProjectDefault?boolean

Whether or not the newly created pipeline should be set as the default pipeline for this project

isLegacy?boolean

Whether or not the pipeline is enabled for Release Automation.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/projects/string/release-pipelines" \  -H "Content-Type: application/json" \  -d '{    "key": "standard-pipeline",    "name": "Standard Pipeline",    "phases": [      {        "audiences": [          {            "environmentKey": "string",            "name": "string"          }        ],        "name": "Phase 1 - Testing"      }    ]  }'
{  "createdAt": "1684262711507",  "description": "Standard pipeline to roll out to production",  "key": "standard-pipeline",  "name": "Standard Pipeline",  "phases": [    {      "id": "1234a56b7c89d012345e678f",      "audiences": [        {          "environment": {            "_links": {              "self": {                "href": "/api/v2/projects/my-project/environments/my-environment",                "type": "application/json"              }            },            "key": "environment-key-123abc",            "name": "My Environment",            "color": "F5A623"          },          "name": "Phase 1 - Testing",          "configuration": {            "releaseStrategy": "monitoredRelease",            "requireApproval": true,            "notifyMemberIds": [              "1234a56b7c89d012345e678f"            ],            "notifyTeamKeys": [              "example-reviewer-team"            ],            "releaseGuardianConfiguration": {              "monitoringWindowMilliseconds": 60000,              "rolloutWeight": 50,              "rollbackOnRegression": true,              "randomizationUnit": "user"            }          },          "segmentKeys": [            "segment-key-123abc"          ]        }      ],      "name": "Phase 1 - Testing",      "configuration": {}    }  ],  "tags": [    "example-tag"  ],  "_version": 1,  "_access": {    "denied": [      {        "action": "string",        "reason": {          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "notResources": [            "string"          ],          "actions": [            "*"          ],          "notActions": [            "string"          ],          "effect": "allow",          "role_name": "string"        }      }    ],    "allowed": [      {        "action": "string",        "reason": {          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "notResources": [            "string"          ],          "actions": [            "*"          ],          "notActions": [            "string"          ],          "effect": "allow",          "role_name": "string"        }      }    ]  },  "isProjectDefault": true,  "_isLegacy": true}