Last hour of usage and a list of applications that have reported seeing this feature toggle
GET <your-unleash-url>/api/admin/client-metrics/features/:name
Authorization
name: Authorizationtype: apiKeyin: header
Separate counts for yes (enabled), no (disabled), as well as how many times each variant was selected during the last hour
Request
Path Parameters
- name string required
- 200
- 401
- 403
- 404
featureUsageSchema
- application/json
- Schema
- Example (from schema)
Schema
- version integer required
Possible values:
>= 1
The version of this schema
- maturity string required
The maturity level of this API (alpha, beta, stable, deprecated)
- featureName string required
The name of the feature
lastHourUsage object[]required
- seenApplications string[] required
A list of applications seen using this feature
{
"version": 0,
"maturity": "stable",
"featureName": "my.special.feature",
"lastHourUsage": [
{
"featureName": "my.special.feature",
"appName": "accounting",
"environment": "development",
"timestamp": "2023-07-27T11:23:44Z",
"yes": 974,
"no": 50,
"variants": {
"variantA": 15,
"variantB": 25,
"variantC": 5
}
}
],
"seenApplications": [
"accounting",
"billing",
"booking"
]
}
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
- id string
The ID of the error instance
- name string
The name of the error kind
- message string
A description of what went wrong.
{
"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
- id string
The ID of the error instance
- name string
The name of the error kind
- message string
A description of what went wrong.
{
"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
- id string
The ID of the error instance
- name string
The name of the error kind
- message string
A description of what went wrong.
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "NotFoundError",
"message": "Could not find the addon with ID \"12345\"."
}
Authorization
name: Authorizationtype: apiKeyin: header
Request
Request
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'
curl -L -X GET '<your-unleash-url>/api/admin/client-metrics/features/:name' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>'