Get all events related to a specific feature flag.

curl https://app.unleash-instance.example.com/api/admin/events/featureName \
     -H "Authorization: <apiKey>"

{
  "events": [
    {
      "id": 1,
      "createdAt": "2023-07-05T12:56:00.000Z",
      "type": "feature-created",
      "createdBy": "johndoe",
      "createdByUserId": 1337,
      "environment": "development",
      "project": "default",
      "featureName": "my.first.feature",
      "data": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "preData": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "tags": [
        {
          "value": "a-tag-value",
          "type": "simple",
          "color": "#FFFFFF"
        }
      ],
      "label": "string",
      "summary": "string",
      "ip": "192.168.1.1",
      "groupType": "change-request",
      "groupId": "01HQVX5K8P9EXAMPLE123456"
    }
  ],
  "version": 1,
  "toggleName": "my.first.feature.flag",
  "totalEvents": 13
}

curl https://app.unleash-instance.example.com/api/admin/events/featureName \
     -H "Authorization: <apiKey>"

{
  "events": [
    {
      "id": 1,
      "createdAt": "2023-07-05T12:56:00.000Z",
      "type": "feature-created",
      "createdBy": "johndoe",
      "createdByUserId": 1337,
      "environment": "development",
      "project": "default",
      "featureName": "my.first.feature",
      "data": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "preData": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "tags": [
        {
          "value": "a-tag-value",
          "type": "simple",
          "color": "#FFFFFF"
        }
      ],
      "label": "string",
      "summary": "string",
      "ip": "192.168.1.1",
      "groupType": "change-request",
      "groupId": "01HQVX5K8P9EXAMPLE123456"
    }
  ],
  "version": 1,
  "toggleName": "my.first.feature.flag",
  "totalEvents": 13
}

Returns all events related to the specified feature flag. If the feature flag does not exist, the list of events will be empty.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

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

Path parameters

featureNamestringRequired

Response

featureEventsSchema

eventslist of objects

The list of events

versionenum

An API versioning number

Allowed values:

toggleNamestring

The name of the feature flag these events relate to

totalEventsinteger>=0

How many events are there for this feature flag

Errors

401

Unauthorized Error

$	curl https://app.unleash-instance.example.com/api/admin/events/featureName \
>	-H "Authorization: <apiKey>"

1	{
2	"events": [
3	{
4	"id": 1,
5	"createdAt": "2023-07-05T12:56:00.000Z",
6	"type": "feature-created",
7	"createdBy": "johndoe",
8	"createdByUserId": 1337,
9	"environment": "development",
10	"project": "default",
11	"featureName": "my.first.feature",
12	"data": {
13	"name": "new-feature",
14	"description": "Flag description",
15	"type": "release",
16	"project": "my-project",
17	"stale": false,
18	"variants": [],
19	"createdAt": "2022-05-31T13:32:20.547Z",
20	"lastSeenAt": null,
21	"impressionData": true
22	},
23	"preData": {
24	"name": "new-feature",
25	"description": "Flag description",
26	"type": "release",
27	"project": "my-project",
28	"stale": false,
29	"variants": [],
30	"createdAt": "2022-05-31T13:32:20.547Z",
31	"lastSeenAt": null,
32	"impressionData": true
33	},
34	"tags": [
35	{
36	"value": "a-tag-value",
37	"type": "simple",
38	"color": "#FFFFFF"
39	}
40	],
41	"label": "string",
42	"summary": "string",
43	"ip": "192.168.1.1",
44	"groupType": "change-request",
45	"groupId": "01HQVX5K8P9EXAMPLE123456"
46	}
47	],
48	"version": 1,
49	"toggleName": "my.first.feature.flag",
50	"totalEvents": 13
51	}