List 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.
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
room_id?stringOnly this Room.
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$business_id?stringOnly events about this business.
^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$task_id?stringOnly this task's events.
^tsk_[0-7][0-9A-HJKMNP-TV-Z]{25}$actor?|Only what this person did: me, or their user id.
about?stringme: 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.
1 <= items <= 20since?stringISO date and time: only events since then.
length <= 40after?stringnext_cursor from the previous page.
^[1-9][0-9]{0,17}$limit?integer1 <= value <= 100SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
uuidSuccessful authorized response.
application/json- response
data*array<>next_cursor*string|nullrequest_id*stringcurl -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"}