List events
Lists what happened, newest first, in one Room (room_id), about one business (business_id), or across all your Rooms. Each event says who did it, through which app (SMB, Claude, ChatGPT, an API key), and what about. Same visibility as each Room's Activity. Filter by types, actor (me or a user id), or about=me.
Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.
In: header
Query Parameters
Only this Room.
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$Only events about this business.
^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$Only what this person did: me, or their user id.
me: tasks given to you, approvals asked of you, your shared apps read.
Types (file.version_added) or kinds (file.*), comma-separated.
1 <= items <= 20ISO date and time: only events since then.
length <= 40next_cursor from the previous page.
^[1-9][0-9]{0,17}$1 <= value <= 100Header Parameters
Workspace where this operation runs. Required for user tokens and Workspace API keys.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
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" } }, "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"}