Get an overview of a project insights.
GET/api/admin/projects/:projectId/insights
This endpoint returns insights into the specified projects stats, health, lead time for changes, feature types used, members and change requests.
Request
Path Parameters
Responses
- 200
- 401
- 403
- 404
projectInsightsSchema
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
stats
object
required
Project statistics
The average time from when a feature was created to when it was enabled in the "production" environment during the current window
10
The number of feature flags created during the current window
15
The number of feature flags created during the previous window
15
The number of feature flags that were archived during the current window
5
The number of feature flags that were archived during the previous window
5
The number of project events that occurred during the current window
100
The number of project events that occurred during the previous window
100
The number of members that were added to the project during the current window
1
health
object
required
Health summary of the project
The number of active feature flags.
12
The number of potentially stale feature flags.
5
The number of stale feature flags.
10
leadTime
object
required
Lead time (DORA) metrics
The average time it takes a feature flag to be enabled in production. The measurement unit is days.
features
object[]
required
An array of objects containing feature flag name and timeToProduction values. The measurement unit of timeToProduction is days.
The name of a feature flag
The average number of days it takes a feature flag to get into production
featureTypeCounts
object[]
required
The number of features of each type
Type of the flag e.g. experiment, kill-switch, release, operational, permission
kill-switch
Number of feature flags of this type
1
members
object
required
Active/inactive users summary
The number of total project members
10
The change in the number of project members compared to the previous month
10
{
"stats": {
"avgTimeToProdCurrentWindow": 10,
"createdCurrentWindow": 15,
"createdPastWindow": 15,
"archivedCurrentWindow": 5,
"archivedPastWindow": 5,
"projectActivityCurrentWindow": 100,
"projectActivityPastWindow": 100,
"projectMembersAddedCurrentWindow": 1
},
"health": {
"rating": 95,
"activeCount": 12,
"potentiallyStaleCount": 5,
"staleCount": 10
},
"leadTime": {
"projectAverage": 0,
"features": [
{
"name": "string",
"timeToProduction": 0
}
]
},
"featureTypeCounts": [
{
"type": "kill-switch",
"count": 1
}
],
"members": {
"currentMembers": 10,
"change": 10
}
}
Authorization information is missing or invalid. Provide a valid API token as the authorization
header, e.g. authorization:*.*.my-admin-token
.
- application/json
- Schema
- Example (from schema)
Schema
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
AuthenticationRequired
A description of what went wrong.
You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login.
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "AuthenticationRequired",
"message": "You must log in to use Unleash. Your request had no authorization header, so we could not authorize you. Try logging in at /auth/simple/login."
}
The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- application/json
- Schema
- Example (from schema)
Schema
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
NoAccessError
A description of what went wrong.
You need the "UPDATE_ADDON" permission to perform this action in the "development" environment.
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "NoAccessError",
"message": "You need the \"UPDATE_ADDON\" permission to perform this action in the \"development\" environment."
}
The requested resource was not found.
- application/json
- Schema
- Example (from schema)
Schema
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
NotFoundError
A description of what went wrong.
Could not find the addon with ID "12345".
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "NotFoundError",
"message": "Could not find the addon with ID \"12345\"."
}