Release policies (beta)

List release policies

GET
/api/v2/projects/{projectKey}/release-policies

Get a list of release policies for the specified project with optional filtering.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

projectKey*string

The project key

Query Parameters

excludeDefault?boolean

When true, exclude the default release policy from the response. When false or omitted, include the default policy if an environment filter is present.

Defaultfalse

Header Parameters

LD-API-Version*"beta"

Version of the endpoint.

Value in

  • "beta"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/projects/default/release-policies?excludeDefault=false" \  -H "LD-API-Version: beta"
{  "totalCount": 42,  "items": [    {      "releaseMethod": "guarded-release",      "_access": {        "allowed": [          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          },          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          }        ],        "denied": [          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          },          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          }        ]      },      "scope": {        "environmentKeys": [          "production",          "staging"        ],        "flagTagKeys": [          "frontend",          "backend"        ],        "viewKeys": [          "feature-a",          "team-a"        ]      },      "progressiveReleaseConfig": {        "rolloutContextKindKey": "user",        "stages": [          {            "allocation": 25000,            "durationMillis": 60000          },          {            "allocation": 25000,            "durationMillis": 60000          }        ]      },      "name": "Production Release",      "rank": 1,      "_id": "550e8400-e29b-41d4-a716-446655440000",      "guardedReleaseConfig": {        "metricKeys": [          "http-errors",          "latency"        ],        "rolloutContextKindKey": "user",        "metricGroupKeys": [          "frontend-metrics",          "backend-metrics"        ],        "minSampleSize": 100,        "stages": [          {            "allocation": 25000,            "durationMillis": 60000          },          {            "allocation": 25000,            "durationMillis": 60000          }        ],        "rollbackOnRegression": true      },      "key": "production-release"    },    {      "releaseMethod": "guarded-release",      "_access": {        "allowed": [          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          },          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          }        ],        "denied": [          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          },          {            "reason": {              "role_name": "role_name",              "notActions": [                null,                null              ],              "notResources": [                "notResources",                "notResources"              ],              "effect": "allow",              "resources": [                "proj/*:env/*;qa_*:/flag/*"              ],              "actions": [                "*"              ]            },            "action": "action"          }        ]      },      "scope": {        "environmentKeys": [          "production",          "staging"        ],        "flagTagKeys": [          "frontend",          "backend"        ],        "viewKeys": [          "feature-a",          "team-a"        ]      },      "progressiveReleaseConfig": {        "rolloutContextKindKey": "user",        "stages": [          {            "allocation": 25000,            "durationMillis": 60000          },          {            "allocation": 25000,            "durationMillis": 60000          }        ]      },      "name": "Production Release",      "rank": 1,      "_id": "550e8400-e29b-41d4-a716-446655440000",      "guardedReleaseConfig": {        "metricKeys": [          "http-errors",          "latency"        ],        "rolloutContextKindKey": "user",        "metricGroupKeys": [          "frontend-metrics",          "backend-metrics"        ],        "minSampleSize": 100,        "stages": [          {            "allocation": 25000,            "durationMillis": 60000          },          {            "allocation": 25000,            "durationMillis": 60000          }        ],        "rollbackOnRegression": true      },      "key": "production-release"    }  ]}