v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Events

Get the most recent events from the Unleash instance or all events related to a project.

Returns the last 100 events from the Unleash instance when called without a query parameter. When called with a project parameter, returns all events for the specified project.

If the provided project does not exist, the list of events will be empty.

get/api/admin/events

Query parameters

projectstring

The name of the project whose events you want to retrieve

Response

eventsSchema

version1 required

The api version of this response. A natural increasing number. Only increases if format changes

totalEventsinteger

The total count of events

Example response

{
  "version": 1,
  "events": [
    {
      "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"
        }
      ],
      "ip": "192.168.1.1",
      "groupType": "change-request",
      "groupId": "01HQVX5K8P9EXAMPLE123456"
    }
  ],
  "totalEvents": 842
}