Releases (beta)

Update phase status for release

PUT
/api/v2/projects/{projectKey}/flags/{flagKey}/release/phases/{phaseId}

Updates the execution status of a phase of a release

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

projectKey*string

The project key

Formatstring
flagKey*string

The flag key

Formatstring
phaseId*string

The phase ID

Formatstring

Request Body

application/json

status?PhaseStatus

Status of the phase

Value in

  • "NotStarted"
  • "ReadyToStart"
  • "Started"
  • "Paused"
  • "Complete"
audiences?array<>

Extra configuration for audiences required upon phase initialization.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/api/v2/projects/string/flags/string/release/phases/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "_links": {    "property1": {      "href": "string",      "type": "string"    },    "property2": {      "href": "string",      "type": "string"    }  },  "name": "Example release pipeline",  "releasePipelineKey": "example-release-pipeline",  "releasePipelineDescription": "Our release pipeline for typical testing and deployment",  "phases": [    {      "_id": "1234a56b7c89d012345e678f",      "_name": "Phase 1 - Testing",      "complete": true,      "_creationDate": "1684262711507",      "_completionDate": "1684262711509",      "_completedBy": {        "member": {          "_links": {            "self": {              "href": "/api/v2/members/569f183514f4432160000007",              "type": "application/json"            }          },          "_id": "569f183514f4432160000007",          "firstName": "Ariel",          "lastName": "Flores",          "role": "admin",          "email": "ariel@acme.com"        },        "token": {          "_links": {            "property1": {              "href": "string",              "type": "string"            },            "property2": {              "href": "string",              "type": "string"            }          },          "_id": "string",          "name": "DevOps token",          "ending": "2345",          "serviceToken": false        }      },      "_audiences": [        {          "_id": "1234a56b7c89d012345e678g",          "_links": {            "property1": {              "href": "string",              "type": "string"            },            "property2": {              "href": "string",              "type": "string"            }          },          "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"          ],          "status": "active",          "_ruleIds": [            "string"          ]        }      ],      "status": "Started",      "started": true,      "_startedDate": 0,      "configuration": {}    }  ],  "_version": 1,  "_releaseVariationId": "string",  "_canceledAt": "1684262711507"}