---
title: "Suggest folders for files with AI"
method: POST
path: "/rooms/{room_id}/suggestions"
tags: ["dataroom"]
---

# Suggest folders for files with AI

`POST /rooms/{room_id}/suggestions`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/rooms/{room_id}/suggestions`
- Auth: HTTP bearer

The workspace's decision model reads each file's name and first pages and suggests one of the room's folders, with its band, and asks whether the file is written to steer an AI, which keeps its text from agents until a member clears it. Suggestions wait for a person to file them. Once people have confirmed enough of these suggestions on this instance, a high answer files a document on its own, only into a folder no link opens, marked as filed automatically. Needs the owner's switch for filing with AI and a decision model.

## Path parameters

- `room_id` string, required

## Request body

- object
  - `item_ids` string[], required

## Response `200`

The result.

- object
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `round_id` string, nullable, required
  - `template` 'blank' | 'seed' | 'spinout', required
  - `checklist_notice` string, nullable, required
  - `questions` boolean, required
  - `archived_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `folders` object[], required
    - `id` string, required
    - `parent_id` string, nullable, required
    - `name` string, required
    - `index` string, required
  - `items` object[], required
    - `id` string, required
    - `document_id` string, required
    - `title` string, required
    - `folder_id` string, nullable, required
    - `to_sort` boolean, required
    - `index` string, nullable, required
    - `version` integer, required
    - `newest_version` integer, required
    - `pinned` boolean, required
    - `pages` integer, required
    - `shared_by` integer, required
    - `added_at` string, date-time, required
    - `suggestion` object, nullable, required
      - `decision_id` string, required
      - `folder_id` string, nullable, required
      - `probability` number, required
      - `band` 'high' | 'medium' | 'low', required
    - `filed_automatically` boolean, required
  - `checklist` object[], required
    - `id` string, required
    - `section` string, required
    - `title` string, required
    - `hint` string, nullable, required
    - `review` boolean, required
    - `status` 'missing' | 'present' | 'review' | 'na', required
    - `document_id` string, nullable, required
    - `document_title` string, nullable, required
    - `reason` string, nullable, required
    - `recorded_at` string, date-time, nullable, required
    - `clause` object, nullable, required
      - `decision_id` string, required
      - `page` integer, required
      - `passage` string, required
      - `band` 'high' | 'medium' | 'low', required
  - `links` object[], required
    - `id` string, required
    - `document_id` string, nullable, required
    - `document_title` string, required
    - `room` object, nullable, required
      - `id` string, required
      - `folders` object[], required
        - `id` string, required
        - `name` string, required
    - `url` string, required
    - `access` 'named' | 'email' | 'verified' | 'public', required
    - `label` string, nullable, required
    - `recipient_email` string, nullable, required
    - `allow` string[], required
    - `access_requests` object[], required
      - `id` string, required
      - `email` string, required
      - `kind` 'access' | 'nda_waiver', required
      - `created_at` string, date-time, required
    - `downloads` boolean, required
    - `detailed_analytics` boolean, required
    - `passcode` boolean, required
    - `nda` object, nullable, required
      - `document_id` string, required
      - `title` string, required
    - `notice` string, nullable, required
    - `protection` 'open' | 'protected' | 'locked', required
    - `mark_style` 'band' | 'tiled', required
    - `round_id` string, nullable, required
    - `round` object, nullable, required
      - `id` string, required
      - `name` string, required
      - `mode` '506b' | '506c' | 'reg_s', required
    - `public_blocked` string, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `state` 'active' | 'paused' | 'expired' | 'revoked', required
    - `paused_reason` string, nullable, required
    - `preshare` object, nullable, required
      - `flags` object[], required
        - `key` string, required
        - `kind` 'ssn' | 'card' | 'iban' | 'routing' | 'ein' | 'cap' | 'comments' | 'paths' | 'author', required
        - `document_id` string, required
        - `document` string, required
        - `page` integer, nullable, required
        - `text` string, required
        - `holds` boolean, required
        - `boxes` object[], required
          - `page` integer, required
          - `x` number, required
          - `y` number, required
          - `width` number, required
          - `height` number, required
      - `checked` string[], required
      - `acknowledged` object, nullable, required
        - `by` string, required
        - `at` string, date-time, required
      - `advisory` object[], required
        - `key` string, required
        - `document_id` string, required
        - `document` string, required
        - `page` integer, nullable, required
        - `text` string, required
        - `band` 'high' | 'medium' | 'low', required
        - `question` string, required
        - `probability` number, required
        - `source` 'model' | 'agent', required
      - `skipped` string[], required
    - `views` integer, required
    - `last_viewed_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
  - `following` boolean, required
  - `open_questions` integer, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)