Insights charts (beta)

Get stale flags chart data

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Get stale flags chart data. Engineering insights displays stale flags data in the flag health metric view.

Expanding the chart response

LaunchDarkly supports expanding the chart response to include additional fields.

To expand the response, append the expand query parameter and include the following:

metrics includes details on the metrics related to stale flags

For example, use ?expand=metrics to include the metrics field in the response. By default, this field is not included in the response.

GET

api

engineering-insights

charts

flags

stale

Get stale flags chart data

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "summary": {},
    "xAxis": "timestamp",
    "yAxis": "count",
    "name": "deploymentFrequency",
    "metrics": {}
  },
  "series": [
    {
      "metadata": {
        "name": "<string>",
        "count": 123,
        "bounds": [
          {
            "name": "equal",
            "value": 100
          }
        ]
      },
      "data": [
        {
          "x": 1617225600000,
          "y": 100,
          "values": {}
        }
      ]
    }
  ]
}

{
  "code": "invalid_request",
  "message": "validation failed",
  "errors": [
    {
      "attribute": "projectKey",
      "reason": "must be present"
    }
  ]
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "forbidden",
  "message": "Forbidden. Access to the requested resource was denied."
}

{
  "code": "not_found",
  "message": "Invalid resource identifier"
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}

Authorizations

Authorization

string

header

required

Query Parameters

projectKey

string<string>

required

The project key

environmentKey

string<string>

required

The environment key

applicationKey

string<string>

Comma separated list of application keys

groupBy

string<string>

Property to group results by. Options: maintainer

maintainerId

string<string>

Comma-separated list of individual maintainers to filter results.

maintainerTeamKey

string<string>

Comma-separated list of team maintainer keys to filter results.

expand

string<string>

Options: metrics

Response

Chart response

metadata

object

required

Metadata for the chart

Show child attributes

series

object[]

required

Series data for the chart

Show child attributes

⌘I

Get stale flags chart data

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.launchdarkly.com/api/v2/engineering-insights/charts/flags/stale")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "summary": {},
    "xAxis": "timestamp",
    "yAxis": "count",
    "name": "deploymentFrequency",
    "metrics": {}
  },
  "series": [
    {
      "metadata": {
        "name": "<string>",
        "count": 123,
        "bounds": [
          {
            "name": "equal",
            "value": 100
          }
        ]
      },
      "data": [
        {
          "x": 1617225600000,
          "y": 100,
          "values": {}
        }
      ]
    }
  ]
}

{
  "code": "invalid_request",
  "message": "validation failed",
  "errors": [
    {
      "attribute": "projectKey",
      "reason": "must be present"
    }
  ]
}

{
  "code": "unauthorized",
  "message": "Invalid access token"
}

{
  "code": "forbidden",
  "message": "Forbidden. Access to the requested resource was denied."
}

{
  "code": "not_found",
  "message": "Invalid resource identifier"
}

{
  "code": "rate_limited",
  "message": "You've exceeded the API rate limit. Try again later."
}