# List Room activity (/docs/api-reference/list_room_activity)

`GET /v1/rooms/{room_id}/activity` · operation `list_room_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.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in; or a Workspace API key in the `X-SMB-API-Key` header.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `room_id` | string | yes |  |

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no |  |
| `after` | string | no | next_cursor from the previous page. |
| `types` | array of one of `room`, `member`, `file`, `tool`, `agent`, `task`, `approval` | no | Only these kinds: room, member, file, tool, agent, task, approval. |
| `actor_user_id` | string (uuid) | no | Only what this person did. |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes | Workspace where this operation runs. Required for user tokens and Workspace API keys. |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | yes |  |
| `data[].activity_id` | string (uuid) | yes |  |
| `data[].occurred_at` | string | yes |  |
| `data[].type` | string | yes |  |
| `data[].actor` | object | yes |  |
| `data[].subject` | object or null | no |  |
| `data[].target` | object | yes |  |
| `data[].room_file_id` | string or null | yes |  |
| `data[].task_id` | string or null | yes |  |
| `data[].connection_id` | string (uuid) or null | yes |  |
| `data[].approval_id` | string (uuid) or null | yes |  |
| `data[].detail` | object | yes |  |
| `data[].mine` | boolean or null | yes |  |
| `data[].room` | object | no |  |
| `next_cursor` | string or null | yes |  |
| `request_id` | string | yes |  |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request GET "https://api.smb.co/v1/rooms/$ROOM_ID/activity" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```