Release pipelines (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.

You can use release pipelines to ensure that you correctly roll out the flag in each environment before moving on to the next. You can also use them to view the status of ongoing releases across all flags within a project, enforcing a standardized process and ensuring they are following best practices. To learn more, read Release pipelines.

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

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

Get all release pipelines

Get all release pipelines for a project

Request
path Parameters
projectKey
required
string <string>

The project key

Responses
200

Release pipeline collection

404

Invalid resource identifier

get/api/v2/projects/{projectKey}/release-pipelines
Request samples 
Response samples 
application/json
{
  • "items": [
    ],
  • "totalCount": 1
}
Create a release pipeline
Creates a new release pipeline


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


 
Request Body schema: application/json
required
description
string
The release pipeline description


 
key
required
string
The unique identifier of this release pipeline


 
name
required
string
The name of the release pipeline


 
required
Array of objects (CreatePhaseInput) 
A logical grouping of one or more environments that share attributes for rolling out changes


 
tags
Array of strings
A list of tags for this release pipeline


 
Responses 
201
Release pipeline response


400
Invalid request


403
Forbidden


404
Invalid resource identifier


409
Status conflict


post/api/v2/projects/{projectKey}/release-pipelines
Request samples 
application/json
{
  • "description": "Standard pipeline to roll out to production",
  • "key": "standard-pipeline",
  • "name": "Standard Pipeline",
  • "phases": [
    ],
  • "tags": [
    ]
}
Response samples 
application/json
{
  • "createdAt": "1684262711507",
  • "description": "Standard pipeline to roll out to production",
  • "key": "standard-pipeline",
  • "name": "Standard Pipeline",
  • "phases": [
    ],
  • "tags": [
    ],
  • "_version": 1
}
Get release pipeline by key
Get a release pipeline by key


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


 
pipelineKey
required
string <string> 
The release pipeline key


 
Responses 
200
Release pipeline response


404
Invalid resource identifier


get/api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}
Request samples 
Response samples 
application/json
{
  • "createdAt": "1684262711507",
  • "description": "Standard pipeline to roll out to production",
  • "key": "standard-pipeline",
  • "name": "Standard Pipeline",
  • "phases": [
    ],
  • "tags": [
    ],
  • "_version": 1
}
Delete release pipeline
Delete a release pipeline


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


 
pipelineKey
required
string <string> 
The release pipeline key


 
Responses 
204
Action succeeded


403
Forbidden


404
Invalid resource identifier


delete/api/v2/projects/{projectKey}/release-pipelines/{pipelineKey}
Request samples 
Response samples 
application/json
{
  • "code": "forbidden",
  • "message": "Forbidden. Access to the requested resource was denied."
}
➔ Next to Releases (beta)