# Get Room File (/docs/api-reference/get_room_file)

`GET /v1/room-files/{room_file_id}` · operation `get_room_file`

Gets one Room File by its Room File ID, as list_room_files shows it, when you can open that file. Use it to look at a file you already know without listing its Room. Does not change the file.

**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_file_id` | string | yes | Stable Room File attachment ID. |

### 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 |
| --- | --- | --- | --- |
| `room_file` | object | yes |  |
| `room_file.room_file_id` | string | yes | Stable Room File attachment ID. |
| `room_file.room_id` | string | yes | Room containing this attachment. |
| `room_file.file` | object | yes |  |
| `room_file.file_version_id` | string | yes | The File version this Room shows: its newest ready version, which follows new uploads. |
| `room_file.access_mode` | one of `inherit_room`, `restricted`, `private` | yes |  |
| `room_file.status` | one of `pending`, `active`, `archived` | yes |  |
| `room_file.revision` | integer | yes |  |
| `room_file.attached_at` | string (date-time) | yes |  |
| `room_file.updated_at` | string (date-time) | yes |  |
| `room_file.archived_at` | string (date-time) or null | yes |  |
| `room_file.access_level` | one of `view`, `edit`, `full_access` | yes |  |
| `room_file.folder_id` | string or null | no | The Room folder it is in; null at the Room's top level. |
| `room_file.original_name` | string or null | no | The name it was uploaded with, when SMB or a person has renamed it since; null otherwise. |
| `room_file.read_state` | one of `pending`, `done` | no | pending until SMB has read the file, so a name that says little can show as being named. |
| `room_file.suggestion` | object or null | no | SMB's open suggestion for where it goes, for people who can edit it; null when there is none. |
| `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/room-files/$ROOM_FILE_ID" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```