Get integration events for a specific integration configuration.
GET/api/admin/addons/:id/events
Returns a list of integration events belonging to a specific integration configuration, identified by its id.
Request
Path Parameters
Query Parameters
The number of results to return in a page. By default it is set to 50.
The number of results to skip when returning a page. By default it is set to 0.
Responses
- 200
- 401
- 403
- 404
#/components/schemas/integrationEventsSchema
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
integrationEvents
object[]
required
A list of integration events.
The integration event's ID. Integration event IDs are incrementing integers. In other words, a more recently created integration event will always have a higher ID than an older one. This ID is represented as a string since it is a BigInt.
Possible values: Value must match regular expression ^[0-9]+$
7
The ID of the integration that the integration event belongs to.
42
The date and time of when the integration event was created. In other words, the date and time of when the integration handled the event.
2023-12-27T13:37:00+01:00
The state of the integration event. Can be one of success
, failed
or successWithErrors
.
Possible values: [success
, failed
, successWithErrors
]
failed
Details about the state of the integration event.
Status code: 429 - Rate limit reached.
event
object
required
An event describing something happening in the system
The ID of the event. An increasing natural number.
Possible values: >= 1
The time the event happened as a RFC 3339-conformant timestamp.
2023-07-05T12:56:00.000Z
What type of event this is
Possible values: [application-created
, feature-created
, feature-deleted
, feature-updated
, feature-metadata-updated
, feature-variants-updated
, feature-environment-variants-updated
, feature-project-change
, feature-archived
, feature-revived
, feature-import
, feature-tagged
, feature-tag-import
, feature-strategy-update
, feature-strategy-add
, feature-strategy-remove
, feature-type-updated
, feature-completed
, feature-uncompleted
, strategy-order-changed
, drop-feature-tags
, feature-untagged
, feature-stale-on
, feature-stale-off
, drop-features
, feature-environment-enabled
, feature-environment-disabled
, strategy-created
, strategy-deleted
, strategy-deprecated
, strategy-reactivated
, strategy-updated
, strategy-import
, drop-strategies
, context-field-created
, context-field-updated
, context-field-deleted
, project-access-added
, project-access-user-roles-updated
, project-access-group-roles-updated
, project-access-user-roles-deleted
, project-access-group-roles-deleted
, project-access-updated
, project-created
, project-updated
, project-deleted
, project-archived
, project-revived
, project-import
, project-user-added
, project-user-removed
, project-user-role-changed
, project-group-role-changed
, project-group-added
, project-group-removed
, role-created
, role-updated
, role-deleted
, drop-projects
, tag-created
, tag-deleted
, tag-import
, drop-tags
, tag-type-created
, tag-type-deleted
, tag-type-updated
, tag-type-import
, drop-tag-types
, addon-config-created
, addon-config-updated
, addon-config-deleted
, db-pool-update
, user-created
, user-updated
, user-deleted
, drop-environments
, environment-import
, environment-created
, environment-updated
, environment-deleted
, segment-created
, segment-updated
, segment-deleted
, group-created
, group-updated
, group-deleted
, group-user-added
, group-user-removed
, setting-created
, setting-updated
, setting-deleted
, client-metrics
, client-register
, pat-created
, pat-deleted
, public-signup-token-created
, public-signup-token-user-added
, public-signup-token-updated
, change-request-created
, change-request-discarded
, change-added
, change-discarded
, change-edited
, change-request-rejected
, change-request-approved
, change-request-approval-added
, change-request-cancelled
, change-request-sent-to-review
, change-request-schedule-suspended
, change-request-applied
, change-request-scheduled
, change-request-scheduled-application-success
, change-request-scheduled-application-failure
, change-request-configuration-updated
, api-token-created
, api-token-updated
, api-token-deleted
, feature-favorited
, feature-unfavorited
, project-favorited
, project-unfavorited
, features-exported
, features-imported
, service-account-created
, service-account-deleted
, service-account-updated
, feature-potentially-stale-on
, feature-dependency-added
, feature-dependency-removed
, feature-dependencies-removed
, banner-created
, banner-updated
, banner-deleted
, project-environment-added
, project-environment-removed
, default-strategy-updated
, segment-import
, signal-endpoint-created
, signal-endpoint-updated
, signal-endpoint-deleted
, signal-endpoint-token-created
, signal-endpoint-token-updated
, signal-endpoint-token-deleted
, actions-created
, actions-updated
, actions-deleted
]
feature-created
Which user created this event
johndoe
The is of the user that created this event
1337
The feature flag environment the event relates to, if applicable.
development
The project the event relates to, if applicable.
default
The name of the feature flag the event relates to, if applicable.
my.first.feature
Extra associated data related to the event, such as feature flag state, segment configuration, etc., if applicable.
{"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}
Data relating to the previous state of the event's subject.
{"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
object[]
nullable
Any tags related to the event, if applicable.
The value of the tag.
Possible values: >= 2 characters
and <= 50 characters
a-tag-value
The type of the tag
Possible values: >= 2 characters
and <= 50 characters
simple
[Experimental] The concise, human-readable name of the event.
[Experimental] A markdown-formatted summary of the event.
Detailed information about the integration event. The contents vary depending on the type of integration and the specific details.
{"message":"*user@yourcompany.com* created a new *slack-app* integration configuration","channels":["engineering","unleash-updates"]}
{
"integrationEvents": [
{
"id": "7",
"integrationId": 42,
"createdAt": "2023-12-27T13:37:00+01:00",
"state": "failed",
"stateDetails": "Status code: 429 - Rate limit reached.",
"event": {
"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"
},
"details": {
"message": "*user@yourcompany.com* created a new *slack-app* integration configuration",
"channels": [
"engineering",
"unleash-updates"
]
}
}
]
}
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\"."
}