File storage
Managed file storage for reading, writing, listing, and deleting files.
| Property | Value |
|---|---|
| Server ID | long-tail-file-storage |
| Category | Data |
| AI required | No |
| Credential providers | None |
| Tools | 4 |
Access
Section titled “Access”Every tool on this server requires builder access (superadmin or the engineer role).
read_file
Section titled “read_file”Read file content from managed storage. Returns content, size, and detected MIME type. Supports utf-8 (text) or base64 encoding.
Read-safe: Yes · Gate: builder
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string |
Yes | Relative path to the file in managed storage |
encoding |
string |
No | Return encoding: utf-8 or base64 (default utf-8) |
write_file
Section titled “write_file”Write content to a file in managed storage. Creates directories as needed. Returns the storage reference and size.
Read-safe: No · Gate: builder
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string |
Yes | Relative path for the file in managed storage |
content |
string |
Yes | File content to write |
encoding |
string |
No | Content encoding: utf-8 or base64 (default utf-8) |
list_files
Section titled “list_files”List files in a storage directory. Returns file paths, sizes, and modification timestamps.
Read-safe: Yes · Gate: builder
| Parameter | Type | Required | Description |
|---|---|---|---|
directory |
string |
No | Directory path to list (default: /) |
pattern |
string |
No | Glob-like filter pattern, for example *.json |
page_size |
number |
No | Max results per page (default 100) |
continuation_token |
string |
No | Pagination token from a previous response |
delete_file
Section titled “delete_file”Remove a file from managed storage.
Read-safe: No · Gate: builder
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string |
Yes | Relative path to the file to delete |