Skip to main content

Get all events related to a specific feature flag.

GET 
/api/admin/events/:featureName

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

Request​

Path Parameters

    featureName stringrequired

Responses​

featureEventsSchema

Schema

    version integer

    An API versioning number

    Possible values: >= 1, [1]

    Example: 1
    toggleName string

    The name of the feature flag these events relate to

    Example: my.first.feature.flag

    events

    object[]

    required

    The list of events

  • Array [

    • id integerrequired

    The ID of the event. An increasing natural number.

    Possible values: >= 1

    createdAt date-timerequired

    The time the event happened as a RFC 3339-conformant timestamp.

    Example: 2023-07-05T12:56:00.000Z
    type stringrequired

    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]

    Example: feature-created
    createdBy stringrequired

    Which user created this event

    Example: johndoe
    createdByUserId numbernullable

    The is of the user that created this event

    Example: 1337
    environment stringnullable

    The feature flag environment the event relates to, if applicable.

    Example: development
    project stringnullable

    The project the event relates to, if applicable.

    Example: default
    featureName stringnullable

    The name of the feature flag the event relates to, if applicable.

    Example: my.first.feature
    data objectnullable

    Extra associated data related to the event, such as feature flag state, segment configuration, etc., if applicable.

    Example: {"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 objectnullable

    Data relating to the previous state of the event's subject.

    Example: {"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.

  • Array [

    • value stringrequired

    The value of the tag.

    Possible values: >= 2 characters and <= 50 characters

    Example: a-tag-value
    type stringrequired

    The type of the tag

    Possible values: >= 2 characters and <= 50 characters

    Example: simple

  • ]

    • label stringnullable

    [Experimental] The concise, human-readable name of the event.

    summary stringnullable

    [Experimental] A markdown-formatted summary of the event.

  • ]

    • totalEvents integer

    How many events are there for this feature flag

    Example: 13
Loading...