Get the most recent events from the Unleash instance or all events related to a project.
GET<your-unleash-url>/api/admin/events
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.
Request
Query Parameters
project string
The name of the project whose events you want to retrieve
Responses
- 200
- 401
eventsSchema
- application/json
- Schema
- Example (auto)
Schema
versionintegerrequired
The api version of this response. A natural increasing number. Only increases if format changes
Possible values: >= 1
, [1
]
Example:
1
events object[]required
totalEventsinteger
The total count of events
Example:
842
{
"version": 1,
"events": [
{
"id": 0,
"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"
}
],
"label": "string",
"summary": "string"
}
],
"totalEvents": 842
}
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 (auto)
Schema
idstring
The ID of the error instance
Example:
9c40958a-daac-400e-98fb-3bb438567008
namestring
The name of the error kind
Example:
AuthenticationRequired
messagestring
A description of what went wrong.
Example:
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."
}
Authorization: Authorization
name: Authorizationtype: apiKeyin: headerdescription: API key needed to access this API
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L '<your-unleash-url>/api/admin/events' \
-H 'Accept: application/json' \
-H 'Authorization: <Authorization>'
ResponseClear