---
title: "Query events"
method: POST
path: "/event-center"
---

# Query events

`POST /event-center`

## Request body

- EventQuery
  - `query` EventQueryParams
    - `searchText` string — Free text query (currently searches for asset_id)
    - `startTime` string, date-time — The start time of the range in ISO 8601 format.
    - `endTime` string, date-time — The end time of the range in ISO 8601 format.
    - `filters` object[] — Filter key-value pairs for exact match
      - `key` 'integrationId' | 'eventType' | 'location' | 'assetType' | 'owner' — Specifies the valid filters
      - `values` string[]
  - `facets` object[] — Specifies the facet buckets returned by the query
    - `field` 'integrationId' | 'eventType' | 'location' | 'assetType' | 'owner' — Specifies the valid filters
    - `size` integer
  - `size` integer
  - `continuationToken` string

## Response `200`

Event Result Set

- EventResponse
  - `events` Event[]
    - `id` string, uuid
    - `account_id` string
    - `integration_id` string
    - `event_timestamp` string, date-time
    - `event_type` 'guardrails_violation' | 'workspace_run' | 'mutation' | 'iac_status' | 'governance_violation' | 'vcs_push' | 'vcs_pull_request' | 'workflows_run'
    - `provider_type` string
    - `asset_id` string
    - `asset_type` string
    - `event` union
      - MutationCreatedEvent
        - `mutation_id` string
        - `mutation_type` 'create' | 'update' | 'delete'
        - `attributes` object[]
          - `key` string
          - `value` string
      - GuardrailsViolationEvent
        - `guardrail_id` string
        - `rule_type` 'cost' | 'policy' | 'resource'
        - `severity` 'high' | 'medium' | 'low'
        - `status` 'violated' | 'resolved'
        - `violation_timestamp` string, date-time
        - `violation_reason` string
        - `workspaceId` string
      - IaCStatusEvent
        - `status` 'drift' | 'managed' | 'unmanaged' | 'ghost'
        - `driftDetails` object[]
          - `path` string
          - `stateValue` union
            - string
            - number
            - boolean
            - number
          - `inventoryValue` union
            - string
            - number
            - boolean
            - number
      - GovernanceViolationEvent
        - `rule_id` string
      - ClickOpsEvent
        - `event_id` string, uuid
        - `event_name` string
        - `region` string
        - `service` string
        - `owner` string
        - `source_ip` string
        - `agent` string
        - `request_params` string
        - `response_elements` string
        - `tls_details` string
      - VcsPushEvent
        - `repository` string
        - `branch` string
        - `commit_sha` string
        - `commit_message` string
        - `author` string
        - `author_email` string
        - `pusher` string
        - `commits_count` integer
        - `before_sha` string
        - `after_sha` string
      - VcsPullRequestEvent
        - `repository` string
        - `pull_request_id` integer
        - `title` string
        - `description` string
        - `source_branch` string
        - `target_branch` string
        - `author` string
        - `status` string
        - `merged_by` string
        - `reviewers` string[]
        - `labels` string[]
  - `facets` object[] — Specifies the filter buckets
    - `field` 'integrationId' | 'eventType' | 'location' | 'assetType' | 'owner' — Specifies the valid filters
    - `size` integer — The number of unique filter values
    - `values` object[]
      - `value` string — The value of the bucket
      - `count` integer — The number of value occurrences+

---

[API](https://skmtc.net/firefly/apis/event-center-api.md) · [All operations](https://skmtc.net/firefly/apis/event-center-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/event-center-api/revisions/6c922f1deb49/schema)