Beta

List events

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
GET
/v1/events

Lists what happened, newest first, in one Room (room_id), about one business (business_id), to one task (task_id), or across your Workspace. Each event says who did it, through which app (SMB, Claude, ChatGPT, an API key), and what about; a .updated event's data.changes says what changed ({ status: { from: "in_progress", to: "done" } }). Same visibility as each Room's Activity. Filter by types (task.updated, file.*), actor (me or a user id), or about=me.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Query Parameters

room_id?string

Only this Room.

Match^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$
business_id?string

Only events about this business.

Match^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$
task_id?string

Only this task's events.

Match^tsk_[0-7][0-9A-HJKMNP-TV-Z]{25}$
actor?|

Only what this person did: me, or their user id.

about?string

me: tasks given to you, approvals asked of you, your shared apps read.

types?array<string>

Types (task.updated) or kinds (file.*), comma-separated. To see only some changes, read data.changes on each event.

Items1 <= items <= 20
since?string

ISO date and time: only events since then.

Lengthlength <= 40
after?string

next_cursor from the previous page.

Match^[1-9][0-9]{0,17}$
limit?integer
Range1 <= value <= 100

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid

Response Body

Successful authorized response.

application/json
  1. response
data*array<>
next_cursor*string|null
request_id*string
curl -X GET 'https://example.com/v1/events' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "data": [    {      "id": "string",      "type": "string",      "occurred_at": "string",      "room": {        "id": "string",        "title": "string"      },      "actor": {        "type": "person",        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",        "name": "string",        "via": {          "kind": "agent",          "name": "string",          "client_id": "5b3fa7ba-57d3-4017-a65b-d57dcd2db643",          "surface": "string"        }      },      "subject": {        "type": "string",        "id": "string",        "name": "string"      },      "about": {        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",        "email": "string",        "name": "string"      },      "data": {        "property1": null,        "property2": null      },      "mine": true    }  ],  "next_cursor": "string",  "request_id": "string"}