# Accept a Room file suggestion (/docs/api-reference/accept_room_file_suggestion)

`POST /v1/room-file-suggestions/{suggestion_id}/accept` · operation `accept_room_file_suggestion`

Does what SMB suggested for a Room file: finds or makes the folder (a folder that already exists with that name under the same parent is reused, so two files accepted into the same new folder share it) and moves the file there, in one step. If the move fails nothing is left behind. Needs Can edit on the file. Accepting one that is already accepted changes nothing. Returns the Room 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 |
| --- | --- | --- | --- |
| `suggestion_id` | string | yes |  |

### Headers

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

### Request body (JSON)

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `room_file_id` | string | yes | Stable Room File attachment ID. |
| `room_id` | string | yes | Room containing this attachment. |
| `file` | object | yes |  |
| `file.file_id` | string | yes | Stable File ID. |
| `file.business_id` | string or null | yes | Associated Business, or null for a Workspace File. |
| `file.name` | string | yes |  |
| `file.description` | string or null | yes |  |
| `file.classification` | one of `financial`, `legal`, `operational`, `marketing`, `other`, `null` | yes |  |
| `file.tags` | array of string | yes |  |
| `file.origin` | one of `upload`, `artifact`, `legacy_document` | yes |  |
| `file.lifecycle` | one of `active`, `archived` | yes |  |
| `file.current_version` | object or null | yes |  |
| `file.revision` | integer | yes |  |
| `file.created_at` | string (date-time) | yes |  |
| `file.updated_at` | string (date-time) | yes |  |
| `file.archived_at` | string (date-time) or null | yes |  |
| `file.access_level` | one of `view`, `edit`, `full_access` | yes |  |
| `file_version_id` | string | yes | The File version this Room shows: its newest ready version, which follows new uploads. |
| `access_mode` | one of `inherit_room`, `restricted`, `private` | yes |  |
| `status` | one of `pending`, `active`, `archived` | yes |  |
| `revision` | integer | yes |  |
| `attached_at` | string (date-time) | yes |  |
| `updated_at` | string (date-time) | yes |  |
| `archived_at` | string (date-time) or null | yes |  |
| `access_level` | one of `view`, `edit`, `full_access` | yes |  |
| `folder_id` | string or null | no | The Room folder it is in; null at the Room's top level. |
| `original_name` | string or null | no | The name it was uploaded with, when SMB or a person has renamed it since; null otherwise. |
| `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. |
| `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 POST "https://api.smb.co/v1/room-file-suggestions/$SUGGESTION_ID/accept" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'
```