Releases (beta)

This feature is in beta

To use this feature, pass in a header including the LD-API-Version key with value set to beta. Use this header with each call. To learn more, read Beta resources.

Resources that are in beta are still undergoing testing and development. They may change without notice, including becoming backwards incompatible.

Release pipelines track the progression of a feature flag across a series of phases, where each phase consists of one or more environments. When you add a flag to a release pipeline, you create a "release" to track that flag's progress through the pipeline. To learn more, read Release pipelines.

With the releases API, you can view and update the active releases for a given flag.

With the related release pipelines API, you can view, create, and delete release pipelines.

Get release for flag

Get currently active release for a flag

Request
path Parameters
projectKey
required
string <string>

The project key

flagKey
required
string <string>

The flag key

Responses
200

Release response

404

Invalid resource identifier

get/api/v2/flags/{projectKey}/{flagKey}/release
Request samples 
Response samples 
application/json
{
  • "_links": {
    },
  • "name": "Example release pipeline",
  • "releasePipelineKey": "example-release-pipeline",
  • "releasePipelineDescription": "Our release pipeline for typical testing and deployment",
  • "phases": [
    ],
  • "_version": 1
}
Patch release for flag
Update currently active release for a flag. Updating releases requires the JSON patch format. To learn more, read Updates.


You can only use this endpoint to mark a release phase complete or incomplete. To indicate which phase to update, use the array index in the path. For example, to mark the first phase of a release as complete, use the following request body:


  [
    {
      "op": "replace",
      "path": "/phase/0/complete",
      "value": true
    }
  ]



Request 
path Parameters
projectKey
required
string <string> 
The project key


 
flagKey
required
string <string> 
The flag key


 
Request Body schema: application/json
required
 Array 
op
required
string
The type of operation to perform


 
path
required
string
A JSON Pointer string specifying the part of the document to operate on


 
value
required
any
A JSON value used in "add", "replace", and "test" operations


 
Responses 
200
Release response


400
Invalid request


401
Invalid access token


403
Forbidden


404
Invalid resource identifier


429
Rate limited


patch/api/v2/flags/{projectKey}/{flagKey}/release
Request samples 
application/json
[
  • {
    }
]
Response samples 
application/json
{
  • "_links": {
    },
  • "name": "Example release pipeline",
  • "releasePipelineKey": "example-release-pipeline",
  • "releasePipelineDescription": "Our release pipeline for typical testing and deployment",
  • "phases": [
    ],
  • "_version": 1
}
➔ Next to Scheduled changes