Event Streams API

{
  "items": [
    {
      "id": "ev_01abc123-4567-4890-abcd-ef0123456789",
      "event_type": "iam.user.created",
      "source": "iam",
      "company_id": "c0ffee00-cafe-babe-dead-beefcafebabe",
      "actor_id": "u9000000-0000-4000-8000-000000000001",
      "actor_type": "member",
      "correlation_id": "corr_01aaa-bbb-ccc-ddd-eee",
      "payload": {
        "resource_type": "user",
        "resource_id": "u1234567-89ab-4cde-f012-3456789abcde"
      },
      "timestamp": "2026-04-14T10:30:00Z"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

{
  "id": "ev_01abc123-4567-4890-abcd-ef0123456789",
  "event_type": "iam.user.created",
  "source": "iam",
  "company_id": "c0ffee00-cafe-babe-dead-beefcafebabe",
  "actor_id": "u9000000-0000-4000-8000-000000000001",
  "actor_type": "member",
  "correlation_id": "corr_01aaa-bbb-ccc-ddd-eee",
  "payload": {
    "resource_type": "user",
    "resource_id": "u1234567-89ab-4cde-f012-3456789abcde"
  },
  "timestamp": "2026-04-14T10:30:00Z"
}

[
  {
    "slug": "iam.user.created",
    "source": "iam",
    "name": "User Created",
    "description": "A new user was added to the organisation."
  },
  {
    "slug": "iam.role.assigned",
    "source": "iam",
    "name": "Role Assigned",
    "description": "A role was assigned to a member."
  }
]

[
  {
    "id": "global.total_events",
    "source": null,
    "name": "Total Events",
    "description": "Total number of events across all sources.",
    "metric_type": "counter",
    "event_types": ["*"],
    "category": "overview",
    "icon": "activity"
  },
  {
    "id": "global.event_volume",
    "source": null,
    "name": "Event Volume",
    "description": "Event count over time bucketed by granularity.",
    "metric_type": "timeseries",
    "event_types": ["*"],
    "category": "overview",
    "icon": "bar-chart"
  }
]

{
  "results": [
    {
      "metric_id": "global.total_events",
      "metric_type": "counter",
      "value": 12847,
      "buckets": null,
      "items": null,
      "numerator": null,
      "denominator": null
    },
    {
      "metric_id": "global.event_volume",
      "metric_type": "timeseries",
      "value": null,
      "buckets": [
        { "bucket": "2026-04-07T00:00:00Z", "count": 1823, "source": null },
        { "bucket": "2026-04-08T00:00:00Z", "count": 1956, "source": null },
        { "bucket": "2026-04-09T00:00:00Z", "count": 1742, "source": null }
      ],
      "items": null,
      "numerator": null,
      "denominator": null
    }
  ],
  "time_range": {
    "from": "2026-04-07T00:00:00Z",
    "to": "2026-04-14T00:00:00Z"
  }
}

{
  "total_events": 12847,
  "events_by_source": {
    "iam": 3210,
    "workflows": 5102,
    "channels": 1845,
    "agents": 1290,
    "worksheets": 980,
    "buckets": 420
  },
  "active_actors": 47,
  "time_range": {
    "from": "2026-04-07T00:00:00Z",
    "to": "2026-04-14T00:00:00Z"
  }
}

{
  "buckets": [
    { "bucket": "2026-04-14T08:00:00Z", "count": 142, "source": "workflows" },
    { "bucket": "2026-04-14T09:00:00Z", "count": 238, "source": "workflows" },
    { "bucket": "2026-04-14T10:00:00Z", "count": 185, "source": "workflows" }
  ],
  "granularity": "hour"
}

{
  "items": [
    { "key": "workflows.item.updated", "label": "Item Updated", "count": 3214 },
    { "key": "iam.user.logged_in", "label": "User Logged In", "count": 2870 },
    { "key": "channels.message.received", "label": "Message Received", "count": 1503 },
    { "key": "agents.conversation.created", "label": "Conversation Created", "count": 982 },
    { "key": "worksheets.row.created", "label": "Row Created", "count": 741 }
  ],
  "total": 48
}

{
  "items": [
    { "key": "u9000000-0000-4000-8000-000000000001", "label": "Alice Johnson", "count": 1842 },
    { "key": "u9000000-0000-4000-8000-000000000002", "label": "Bob Smith", "count": 1356 },
    { "key": "ak_svc_automation", "label": "Automation API Key", "count": 1102 },
    { "key": "u9000000-0000-4000-8000-000000000003", "label": "Carol Davis", "count": 890 },
    { "key": "u9000000-0000-4000-8000-000000000004", "label": "Dan Lee", "count": 654 }
  ],
  "total": 47
}

{
  "source": "workflows",
  "total_events": 5102,
  "event_types": [
    { "key": "workflows.item.updated", "label": "Item Updated", "count": 3214 },
    { "key": "workflows.item.created", "label": "Item Created", "count": 1020 },
    { "key": "workflows.route.executed", "label": "Route Executed", "count": 868 }
  ],
  "recent_trend": [
    { "bucket": "2026-04-12T00:00:00Z", "count": 723, "source": "workflows" },
    { "bucket": "2026-04-13T00:00:00Z", "count": 698, "source": "workflows" },
    { "bucket": "2026-04-14T00:00:00Z", "count": 412, "source": "workflows" }
  ]
}

{"metrics":[{"id":"workflow.phase.dwell","name":"Phase duration","subject":"phase_visits","grain":"interval","unit":"seconds","status":"available"}],"datasets":[{"id":"workflow_lifecycle","name":"Workflow lifecycle","dimensions":[],"measures":[]}],"operators":{"eq":"Equals"}}

{"labels":[{"entity_type":"phase","entity_id":"11111111-1111-1111-1111-111111111111","name":"Closed intake","workflow_id":"22222222-2222-2222-2222-222222222222","deleted_at":"2026-08-01T00:00:00Z"}]}

{"query_id":"8e9d...","dataset":"workflow_lifecycle","columns":[{"name":"phase_id","label":"Phase","data_type":"string"},{"name":"avg_dwell_seconds","label":"Avg Dwell Seconds","data_type":"number"}],"rows":[{"phase_id":"uuid","avg_dwell_seconds":1842.5}],"total_rows":1,"truncated":false,"warnings":["3 open phase visits excluded from duration aggregates"],"summary":{"row_count":1,"sample_count":45,"closed_observation_count":42,"open_observation_count":3,"truncated":false,"warnings":[]},"provenance":{"metric_id":"workflow.phase.dwell","dataset":"workflow_lifecycle","grain":"interval","event_time_field":"event_time","projection_revision":"workflow_lifecycle_events.v1","includes_open_intervals":true}}

{"dashboard_id":"00000000-0000-0000-0000-000000000000","dashboard_version":0,"widgets":[{"id":"kpi-routed","title":"Transitions","visualization":"stat","result":{"rows":[],"warnings":[]}}],"warnings":[]}

{"items":[],"total":0,"can_create":false}

{"dashboard_id":"view-uuid","dashboard_version":2,"widgets":[],"warnings":[]}

{"id":"job-uuid","status":"queued","progress":0,"manifest":null}

{"id":"job-uuid","status":"succeeded","progress":100,"row_count":42,"byte_count":2048,"expires_at":"2026-08-14T12:00:00Z"}

{"id":"view-uuid","name":"Throughput","visibility":"private","version":1}

{"id":"view-uuid","name":"Throughput","visibility":"shared","version":2,"is_favorite":true}

{"id":"view-uuid","version":3,"can_edit":true}

{"id":"view-uuid","is_favorite":true,"user_position":0}

{"items":[],"total":0,"can_create":false}

[]

{"resource_types":[],"permissions":[]}

{"items":[],"total":0,"page":1,"limit":100}

{"id":"{grant_id}","name":"event-streams:metrics:dashboards:view","resource":"org/{company_id}/dashboard/{dashboard_id}","effect":"allow"}

{"items":[],"total":0}

{"id":"job-uuid","status":"cancelled","progress":42}

downloaded artifact bytes

{
  "items": [
    {
      "correlation_id": "corr_01aaa-bbb-ccc-ddd-eee",
      "event_count": 4,
      "sources": ["iam", "workflows", "channels"],
      "first_event_type": "iam.user.created",
      "started_at": "2026-04-14T10:30:00Z",
      "duration_ms": 4520
    },
    {
      "correlation_id": "corr_02fff-ggg-hhh-iii-jjj",
      "event_count": 3,
      "sources": ["workflows", "agents"],
      "first_event_type": "workflows.item.created",
      "started_at": "2026-04-14T09:15:00Z",
      "duration_ms": 1200
    }
  ],
  "total": 234,
  "limit": 10,
  "offset": 0
}

{
  "correlation_id": "corr_01aaa-bbb-ccc-ddd-eee",
  "events": [
    {
      "id": "ev_01abc123-4567-4890-abcd-ef0123456789",
      "event_type": "iam.user.created",
      "source": "iam",
      "actor_id": "u9000000-0000-4000-8000-000000000001",
      "actor_type": "member",
      "payload": { "resource_type": "user", "resource_id": "u1234567-89ab-4cde-f012-3456789abcde" },
      "timestamp": "2026-04-14T10:30:00Z"
    },
    {
      "id": "ev_02def456-7890-4abc-def0-123456789abc",
      "event_type": "workflows.item.created",
      "source": "workflows",
      "actor_id": "u9000000-0000-4000-8000-000000000001",
      "actor_type": "member",
      "payload": { "resource_type": "item", "resource_id": "wi_99887766", "workflow_id": "wf_01" },
      "timestamp": "2026-04-14T10:30:02Z"
    },
    {
      "id": "ev_03ghi789-0123-4def-0123-456789abcdef",
      "event_type": "channels.message.sent",
      "source": "channels",
      "actor_id": null,
      "actor_type": "system",
      "payload": { "resource_type": "message", "resource_id": "msg_77665544" },
      "timestamp": "2026-04-14T10:30:04.520Z"
    }
  ],
  "sources": ["iam", "workflows", "channels"],
  "started_at": "2026-04-14T10:30:00Z",
  "ended_at": "2026-04-14T10:30:04.520Z",
  "duration_ms": 4520
}

{
  "id": "ev_04jkl012-3456-4789-abcd-ef0123456789",
  "event_type": "workflows.item.updated",
  "source": "workflows",
  "company_id": "c0ffee00-cafe-babe-dead-beefcafebabe",
  "actor_id": "u9000000-0000-4000-8000-000000000002",
  "actor_type": "member",
  "correlation_id": "corr_03kkk-lll-mmm-nnn-ooo",
  "payload": {
    "resource_type": "item",
    "resource_id": "wi_99887766",
    "changed_fields": ["status"]
  },
  "timestamp": "2026-04-14T11:05:33Z"
}