---
title: "Update phase status for release"
method: PUT
path: "/api/v2/projects/{projectKey}/flags/{flagKey}/release/phases/{phaseId}"
tags: ["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

## Path parameters

- `projectKey` string, string, required — The project key
- `flagKey` string, string, required — The flag key
- `phaseId` string, string, required — The phase ID

## Request body

- UpdatePhaseStatusInput
  - `status` string
  - `audiences` ReleaserAudienceConfigInput[] — Extra configuration for audiences required upon phase initialization.
    - `audienceId` string — UUID of the audience.
    - `releaseGuardianConfiguration` ReleaseGuardianConfigurationInput
      - `monitoringWindowMilliseconds` integer — The monitoring window in milliseconds
      - `rolloutWeight` integer — The rollout weight
      - `rollbackOnRegression` boolean — Whether or not to rollback on regression
      - `randomizationUnit` string — The randomization unit for the measured rollout
    - `notifyMemberIds` string[] — An array of member IDs. These members are notified to review the approval request.
    - `notifyTeamKeys` string[] — An array of team keys. The members of these teams are notified to review the approval request.

## Response `200`

Action succeeded

- Release
  - `_links` object — The location and content type of related resources
  - `name` string, required — The release pipeline name
  - `releasePipelineKey` string, required — The release pipeline key
  - `releasePipelineDescription` string, required — The release pipeline description
  - `phases` ReleasePhase[], required — An ordered list of the release pipeline phases
    - `_id` string, required — The phase ID
    - `_name` string, required — The release phase name
    - `complete` boolean, required — Whether this phase is complete
    - `_creationDate` integer, required
    - `_completionDate` integer
    - `_completedBy` CompletedBy
      - `member` MemberSummary
        - `_links` object, required — The location and content type of related resources
        - `_id` string, required — The member's ID
        - `firstName` string — The member's first name
        - `lastName` string — The member's last name
        - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
        - `email` string, required — The member's email address
      - `token` TokenSummary
        - `_links` object
        - `_id` string
        - `name` string — The name of the token
        - `ending` string — The last few characters of the token
        - `serviceToken` boolean — Whether this is a service token
    - `_audiences` ReleaseAudience[], required — A logical grouping of one or more environments that share attributes for rolling out changes
      - `_id` string, required — The audience ID
      - `_links` object — The location and content type of related resources
      - `environment` EnvironmentSummary
        - `_links` object, required — The location and content type of related resources
        - `key` string, required — A project-unique key for the environment
        - `name` string, required — A human-friendly name for the environment
        - `color` string, required — The color used to indicate this environment in the UI
      - `name` string, required — The release phase name
      - `configuration` AudienceConfiguration
        - `releaseStrategy` string, required
        - `requireApproval` boolean, required — Whether or not the audience requires approval
        - `notifyMemberIds` string[] — An array of member IDs. These members are notified to review the approval request.
        - `notifyTeamKeys` string[] — An array of team keys. The members of these teams are notified to review the approval request.
        - `releaseGuardianConfiguration` ReleaseGuardianConfiguration
          - `monitoringWindowMilliseconds` integer, required — The monitoring window in milliseconds
          - `rolloutWeight` integer, required — The rollout weight percentage
          - `rollbackOnRegression` boolean, required — Whether or not to roll back on regression
          - `randomizationUnit` string — The randomization unit for the measured rollout
      - `segmentKeys` string[] — A list of segment keys
      - `status` string
      - `_ruleIds` string[] — The rules IDs added or updated by this audience
    - `status` string
    - `started` boolean — Whether or not this phase has started
    - `_startedDate` integer
    - `configuration` PhaseConfiguration
  - `_version` integer, required — The release version
  - `_releaseVariationId` string — The chosen release variation ID to use across all phases of a release
  - `_canceledAt` integer

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `404` — release or phase not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)