---
title: "Cursor-tail the caller's agentic event log"
method: GET
path: "/api/events/next"
tags: ["events", "browser-session"]
---

# Cursor-tail the caller's agentic event log

`GET /api/events/next`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/events/next`
- Auth: API key in cookie `__session`

Clerk-session only (NOT reachable with an agt_ bearer). Cursor-based tail read of the per-user agentic event log. Pass the last-seen `since` id to page forward; the response carries `cursor` + `has_more` for the next page. Headless agents use the MCP verb `ic_events_next` (bearer-auth) instead.

## Query parameters

- `since` integer
- `types` string
- `limit` integer

## Response `200`

A page of agent events with a forward cursor.

- AgentEventsNextResponse: Cursor-paginated page of agentic events.
  - `events` object[], required
  - `cursor` integer: Pass as `since` to fetch the next page.
  - `has_more` boolean: True when more events remain past this page.
  - `as_of` string, date-time

## Other responses

- `401`: Not signed in.
- `500`: Event log read failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)