Event Center

The Event Center API allows you to query events and facets from Firefly's event tracking system. Events include mutations, guardrail violations, IaC status changes, governance violations, and ClickOps activities.

Query Events

Query events

post

Body

application/json

sizeinteger · max: 100OptionalDefault: 50

continuationTokenstringOptional

Responses

200

Event Result Set

application/json

post

/event-center

HTTPcURLJavaScriptPython

POST /v2/event-center HTTP/1.1
Host: api.firefly.ai
Content-Type: application/json
Accept: */*
Content-Length: 239

{
  "query": {
    "searchText": "text",
    "startTime": "2026-01-20T23:22:33.587Z",
    "endTime": "2026-01-20T23:22:33.587Z",
    "filters": [
      {
        "key": "account_id",
        "values": [
          "text"
        ]
      }
    ]
  },
  "facets": [
    {
      "field": "account_id",
      "size": 10
    }
  ],
  "size": 50,
  "continuationToken": "text"
}

200

Event Result Set

{
  "events": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "account_id": "text",
      "integration_id": "text",
      "event_timestamp": "2026-01-20T23:22:33.587Z",
      "event_type": "guardrails_violation",
      "provider_type": "text",
      "asset_id": "text",
      "asset_type": "text",
      "event": {
        "mutation_id": "text",
        "mutation_type": "create",
        "attributes": [
          {
            "key": "text",
            "value": "text"
          }
        ]
      }
    }
  ],
  "facets": [
    {
      "field": "account_id",
      "size": 1,
      "values": [
        {
          "value": "text",
          "count": 1
        }
      ]
    }
  ]
}

Query Facets

Query facet

post

Body

application/json

Specifies the facet buckets

fieldSearchTextstringOptional

fieldstring · enumOptional

Specifies the valid filters

Possible values:

sizeinteger · max: 100OptionalDefault: 10

Responses

200

Event Result Set

application/json

post

/event-center/facets/{facet}

HTTPcURLJavaScriptPython

POST /v2/event-center/facets/{facet} HTTP/1.1
Host: api.firefly.ai
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "query": {
    "searchText": "text",
    "startTime": "2026-01-20T23:22:33.587Z",
    "endTime": "2026-01-20T23:22:33.587Z",
    "filters": [
      {
        "key": "account_id",
        "values": [
          "text"
        ]
      }
    ]
  },
  "fieldSearchText": "text",
  "field": "account_id",
  "size": 10
}

200

Event Result Set

[
  {
    "field": "account_id",
    "size": 1,
    "values": [
      {
        "value": "text",
        "count": 1
      }
    ]
  }
]