Skip to main content

Search for events

GET /api/admin/search/events

Allows searching for events that match the query parameter criteria.

Request​

Query Parameters

  • query string

    Find events by a free-text search query. The query will be matched against the event data payload (if any).

  • feature string

    Possible values: Value must match regular expression ^(IS|IS_ANY_OF):(.*?)(,([a-zA-Z0-9_]+))*$

    Filter by feature name using supported operators: IS, IS_ANY_OF

  • project string

    Possible values: Value must match regular expression ^(IS|IS_ANY_OF):(.*?)(,([a-zA-Z0-9_]+))*$

    Filter by projects ID using supported operators: IS, IS_ANY_OF.

  • type string

    Possible values: Value must match regular expression ^(IS|IS_ANY_OF):(.*?)(,([a-zA-Z0-9_]+))*$

    Filter by event type using supported operators: IS, IS_ANY_OF.

  • createdBy string

    Possible values: Value must match regular expression ^(IS|IS_ANY_OF):(.*?)(,([a-zA-Z0-9_]+))*$

    Filter by the ID of the event creator, using supported operators: IS, IS_ANY_OF.

  • from string

    Possible values: Value must match regular expression ^(IS):\d{4}-\d{2}-\d{2}$

    The starting date of the creation date range in IS:yyyy-MM-dd format

  • to string

    Possible values: Value must match regular expression ^(IS):\d{4}-\d{2}-\d{2}$

    The ending date of the creation date range in IS:yyyy-MM-dd format

  • offset string

    Default value: 0

    The number of features to skip when returning a page. By default it is set to 0.

  • limit string

    Default value: 50

    The number of feature environments to return in a page. By default it is set to 50. The maximum is 1000.

Responses

eventSearchResponseSchema

Schema
  • events object[]required

    The list of events

  • Array [
  • id integer required

    Possible values: >= 1

    The ID of the event. An increasing natural number.

  • createdAt date-time required

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

  • type string required

    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]

    What type of event this is

  • createdBy string required

    Which user created this event

  • createdByUserId number nullable

    The is of the user that created this event

  • environment string nullable

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

  • project string nullable

    The project the event relates to, if applicable.

  • featureName string nullable

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

  • data object nullable

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

  • preData object nullable

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

  • tags object[]nullable

    Any tags related to the event, if applicable.

  • Array [
  • value string required

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

    The value of the tag.

  • type string required

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

    The type of the tag

  • ]
  • label string nullable

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

  • summary string nullable

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

  • ]
  • total integer required

    The total count of events

Loading...