> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slaunt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Room tools: browse and manage workspace files

> Parameters for Room tools: listing, reading, upload receipts, folders, groups and updates.

Room is the workspace's shared file store, useful for specs, runbooks and reference material agents should read. Items are files, folders or groups (a group is a named set of items across folders). Every item lives in one of two buckets, set by `project_scope`:

| `project_scope` | Bucket | Writes |
| - | - | - |
| `workspace` | Shared across the whole workspace | Workspace admins only |
| `current` | Your project | Any member |
| `all` | Both (listing only) | |

All Room tools need a signed-in user.

## Reading

| Tool | Params |
| - | - |
| `room_items_list` | `project_scope` (default `all`), `parent_item_id` (direct children of a folder), `item_type` (`file`\|`folder`\|`group`), `limit` 1–250 (100), `offset`, `include_group_memberships` (default `false`; leave off unless you need it, it inflates the payload) |
| `room_item_get` | `id` **required**; includes group membership |
| `room_item_content_get` | `id` **required**, `max_chars` 256–20,000 (default 4,000). Text files return a preview; binary files return metadata and a download path. |

## Writing

| Tool | Params |
| - | - |
| `room_folder_create` | `title` **required**, `description`, `parent_item_id`, `project_scope` (default `workspace`, so non-admins should pass `current`) |
| `room_group_create` | Same, plus `item_ids`; members must be in the same bucket |
| `room_item_update` | `id` **required**, `title`, `description`, `parent_item_id` (`""` moves to root), `archived`. Type and bucket can't change; moving a folder into its own descendant is rejected. |

## room\_file\_upload\_prepare

Issues an upload receipt before the file bytes are uploaded. Receipts are single-use, expire, and are tied to the user, folder and bucket, so prepare a new one if anything changes. Uploads count toward the plan's Room upload and storage limits.

| Param | |
| - | - |
| `file_name`, `mime_type`, `size_bytes` | **Required.** Type and size must match the uploaded object exactly. |
| `project_scope` | **Required:** `current` \| `workspace` |
| `parent_item_id`, `extension` | |
| `checksum_sha256` | Lowercase hex of the exact bytes |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.