Get lifecycle trends | Unleash Documentation

curl https://app.unleash-instance.example.com/api/admin/insights/lifecycle \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "lifecycleTrends": {
    "develop": {
      "totalFlags": 42,
      "medianDaysInCurrentStage": 30,
      "medianDaysHistorically": 27,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 18,
          "newFlagsThisWeek": 10
        },
        "release": {
          "flagsOlderThanWeek": 14,
          "newFlagsThisWeek": 2
        },
        "permanent": {
          "flagsOlderThanWeek": 10,
          "newFlagsThisWeek": 1
        }
      }
    },
    "production": {
      "totalFlags": 25,
      "medianDaysInCurrentStage": 20,
      "medianDaysHistorically": 19,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 5,
          "newFlagsThisWeek": 3
        },
        "release": {
          "flagsOlderThanWeek": 7,
          "newFlagsThisWeek": 4
        },
        "permanent": {
          "flagsOlderThanWeek": 8,
          "newFlagsThisWeek": 0
        }
      }
    },
    "cleanup": {
      "totalFlags": 8,
      "medianDaysInCurrentStage": 22,
      "medianDaysHistorically": 20,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 1,
          "newFlagsThisWeek": 2
        },
        "release": {
          "flagsOlderThanWeek": 2,
          "newFlagsThisWeek": 1
        },
        "permanent": {
          "flagsOlderThanWeek": 3,
          "newFlagsThisWeek": 0
        }
      }
    }
  }
}

curl https://app.unleash-instance.example.com/api/admin/insights/lifecycle \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json"

{
  "lifecycleTrends": {
    "develop": {
      "totalFlags": 42,
      "medianDaysInCurrentStage": 30,
      "medianDaysHistorically": 27,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 18,
          "newFlagsThisWeek": 10
        },
        "release": {
          "flagsOlderThanWeek": 14,
          "newFlagsThisWeek": 2
        },
        "permanent": {
          "flagsOlderThanWeek": 10,
          "newFlagsThisWeek": 1
        }
      }
    },
    "production": {
      "totalFlags": 25,
      "medianDaysInCurrentStage": 20,
      "medianDaysHistorically": 19,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 5,
          "newFlagsThisWeek": 3
        },
        "release": {
          "flagsOlderThanWeek": 7,
          "newFlagsThisWeek": 4
        },
        "permanent": {
          "flagsOlderThanWeek": 8,
          "newFlagsThisWeek": 0
        }
      }
    },
    "cleanup": {
      "totalFlags": 8,
      "medianDaysInCurrentStage": 22,
      "medianDaysHistorically": 20,
      "categories": {
        "experimental": {
          "flagsOlderThanWeek": 1,
          "newFlagsThisWeek": 2
        },
        "release": {
          "flagsOlderThanWeek": 2,
          "newFlagsThisWeek": 1
        },
        "permanent": {
          "flagsOlderThanWeek": 3,
          "newFlagsThisWeek": 0
        }
      }
    }
  }
}

Enterprise feature

Gets lifecycle trends information showing feature flag progression across development, production, and cleanup stages.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Query parameters

projectsstringOptional

Comma-separated list of project IDs to filter lifecycle trends

Response

lifecycleTrendsSchema

lifecycleTrendsobject

Aggregated view of feature flag lifecycle across environments

$	curl https://app.unleash-instance.example.com/api/admin/insights/lifecycle \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"

1	{
2	"lifecycleTrends": {
3	"develop": {
4	"totalFlags": 42,
5	"medianDaysInCurrentStage": 30,
6	"medianDaysHistorically": 27,
7	"categories": {
8	"experimental": {
9	"flagsOlderThanWeek": 18,
10	"newFlagsThisWeek": 10
11	},
12	"release": {
13	"flagsOlderThanWeek": 14,
14	"newFlagsThisWeek": 2
15	},
16	"permanent": {
17	"flagsOlderThanWeek": 10,
18	"newFlagsThisWeek": 1
19	}
20	}
21	},
22	"production": {
23	"totalFlags": 25,
24	"medianDaysInCurrentStage": 20,
25	"medianDaysHistorically": 19,
26	"categories": {
27	"experimental": {
28	"flagsOlderThanWeek": 5,
29	"newFlagsThisWeek": 3
30	},
31	"release": {
32	"flagsOlderThanWeek": 7,
33	"newFlagsThisWeek": 4
34	},
35	"permanent": {
36	"flagsOlderThanWeek": 8,
37	"newFlagsThisWeek": 0
38	}
39	}
40	},
41	"cleanup": {
42	"totalFlags": 8,
43	"medianDaysInCurrentStage": 22,
44	"medianDaysHistorically": 20,
45	"categories": {
46	"experimental": {
47	"flagsOlderThanWeek": 1,
48	"newFlagsThisWeek": 2
49	},
50	"release": {
51	"flagsOlderThanWeek": 2,
52	"newFlagsThisWeek": 1
53	},
54	"permanent": {
55	"flagsOlderThanWeek": 3,
56	"newFlagsThisWeek": 0
57	}
58	}
59	}
60	}
61	}