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.
| 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. |
| 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. |
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 |