GET /v1/agents/events

The agents’ activity log, newest first: plans, approvals, actions, AI calls and setup.

Everything every agent did, newest first — the panel’s AI agents → Activity. It is append-only: rows are never changed or removed.

Needs the agents:read scope.

Query parameters

Field	Type	Required	Notes
agent	integer	No	Only this agent’s.
kind	string	No	Only one kind — for example plan_created, approval_requested, approved, rejected, step_done, step_failed, llm_call, assigned, paused, guardrail_blocked or workflow_published.
limit	integer	No	1 to 100; 50 by default.
starting_after	string	No	The last id of the previous page — next from it.

Request

cURL

curl "https://api.fireflo.au/v1/agents/events?agent=7&limit=2" \
  -H "Authorization: Bearer $OMNI_API_KEY"

Response

200 OK — has_more says whether there is another page, and next is the starting_after for it. Each row has its kind, a readable summary, the agent (and agent_name, kept when an agent is renamed or deleted), the contact and plan_id it was about, the person who did it (actor) when a person did, and, for AI calls, the tokens used and the model. contact.uuid is the contact’s id everywhere else in the API.

{
  "data": [
    {
      "id": 118204,
      "at": "2026-10-06T10:21:05+05:30",
      "kind": "approved",
      "agent": {
        "id": 7,
        "name": "Arjun",
        "role": "sales"
      },
      "agent_name": "Arjun",
      "contact": {
        "id": 90417,
        "uuid": "3f6b2a1e-8c4d-4e2a-9b7f-5d1c0e8a9f42",
        "name": "Neha Arora"
      },
      "plan_id": 4812,
      "actor": null,
      "summary": "Plan #4812 approved with edits",
      "tokens": null,
      "model": null
    },
    {
      "id": 118173,
      "at": "2026-10-06T10:14:30+05:30",
      "kind": "llm_call",
      "agent": {
        "id": 7,
        "name": "Arjun",
        "role": "sales"
      },
      "agent_name": "Arjun",
      "contact": {
        "id": 90417,
        "uuid": "3f6b2a1e-8c4d-4e2a-9b7f-5d1c0e8a9f42",
        "name": "Neha Arora"
      },
      "plan_id": 4812,
      "actor": null,
      "summary": "Planned with gpt-4o-mini",
      "tokens": 2310,
      "model": "gpt-4o-mini"
    }
  ],
  "has_more": true,
  "next": "118173"
}

Errors

Every refusal is {"error": {"code", "message", "field"}}; field is there when one input is at fault.

Status	Error code	When
400	invalid_request	limit is out of range, or starting_after isn’t an id from this list; field names it.
404	module_off	The account doesn’t have AI agents on: they aren’t in its plan, or are switched off for it.
403	scope_missing	The key doesn’t have the agents:read scope.

Any request can also be refused for its key, its account or its rate (key_required, invalid_key, account_suspended, plan_excludes_api, address_not_allowed, rate_limited); see the overview.