SMBBETA

List Room activity

Last updated Oct 10, 2026View as MarkdownAgent setup / MCP
GET
/v1/rooms/{room_id}/activity

Lists what happened in a Room, newest first: people joining, files added, viewed and downloaded, tools shared, SMB reading shared tools (what was read; the question only for whoever asked it), tasks and approvals. Full access sees everything; others see Room-wide events, their own activity and what's about them. Prefer list_events (room_id): the same events, with stable ids and the newer names.

Authorization

AuthorizationBearer <token>

Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.

In: header

Path Parameters

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

Query Parameters

limit?integer
Range1 <= value <= 100
after?string

next_cursor from the previous page.

Lengthlength <= 80
types?array<>

Only these kinds: room, member, file, tool, agent, task, approval.

Itemsitems <= 7
actor_user_id?string

Only what this person did.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Header Parameters

SMB-Workspace-Id*string

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

Formatuuid

Response 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/rooms/string/activity" \  -H "SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": [    {      "activity_id": "98dae057-958f-4b2f-9ed4-41f109afdc3f",      "occurred_at": "string",      "type": "string",      "actor": {        "type": "user",        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",        "name": "string"      },      "subject": {        "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",        "email": "string",        "name": "string"      },      "target": {        "type": "string",        "name": "string"      },      "room_file_id": "string",      "task_id": "string",      "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",      "approval_id": "15af2260-72db-4fc4-b587-6b841d6a3d55",      "detail": {        "property1": null,        "property2": null      },      "mine": true,      "room": {        "room_id": "string",        "title": "string"      }    }  ],  "next_cursor": "string",  "request_id": "string"}