# List Room file suggestions (/docs/api-reference/list_room_file_suggestions)

`GET /v1/rooms/{room_id}/file-suggestions` · operation `list_room_file_suggestions`

SMB's open suggestions for where files in a Room belong, for the files you can edit: the folder (or a new folder to make) and how sure SMB is. With drop_batch_id, only the files uploaded together. Nothing moves: accept one with accept_room_file_suggestion (or move the file yourself with move_room_file), or say no with dismiss_room_file_suggestion. A Room can turn suggestions off.

**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 |
| --- | --- | --- | --- |
| `drop_batch_id` | string | no | Only the files uploaded together (the drop_batch_id on a suggestion). |

### 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 |
| --- | --- | --- | --- |
| `suggestions` | array of object | yes |  |
| `suggestions[].suggestion_id` | string | yes |  |
| `suggestions[].state` | `suggested` | yes |  |
| `suggestions[].confidence` | number | yes |  |
| `suggestions[].needs_pick` | boolean | yes | True when SMB is not sure enough to name a folder (low confidence, or a new folder that fewer than two files of the same drop share): show it as Pick a folder. |
| `suggestions[].folder_id` | string or null | yes | The existing folder to move it to; null for a new folder. |
| `suggestions[].parent_folder_id` | string or null | yes | For a new folder: the folder it goes under (the one the file was dropped into); null at the Room's top. |
| `suggestions[].new_folder_path` | array of string or null | yes | For a new folder: its names under parent_folder_id, one to three. accept_room_file_suggestion makes them (reusing ones that exist) and moves the file. |
| `suggestions[].path` | array of string | yes | The folder's full path, top first, as people read it. |
| `suggestions[].reason` | string or null | yes | One line on why. |
| `suggestions[].drop_batch_id` | string | yes | Files uploaded together share it. |
| `suggestions[].room_file_id` | string | yes |  |
| `suggestions[].file_name` | string | 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/file-suggestions" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```