Files
Files is the workspace file library. You upload assets, rename or replace them, copy their URL or id, and download or delete them. Other surfaces (chat, tables, knowledge bases) also create files in related storage buckets; this page is where you manage the shared upload library.
Use it when agents, quick replies, table fields, or workflows need a stable file id or public URL.
When to use
- Store reusable media or documents that agents and workflows can load by id
- Replace or rename an uploaded file without changing its id
- Pick a workspace file for a chat-profile quick reply or a table File / Multi File field
Add a file
Open Data → Files and choose Add File.
- Upload a file.
- Set Name (the extension is shown from the upload).
- Save.
After create, the row menu supports Edit, Copy URL, Copy Id, Download, and Delete.
| Setting | What it does |
|---|---|
| Name | Display name stored without the extension |
| Type | Derived from MIME (image, video, audio, PDF, Word, Excel, presentation, text, archive, or other) |
Search and column filters help you find files by name, type, or MIME.
Edit a file
Edit lets you change the name or replace the binary. Replacement must keep the same generic type (for example, image → image). Type mismatches are rejected.
Use file blocks in agents and workflows
In the builder, use system file blocks:
| Block | What it does |
|---|---|
| Get File | Load file metadata by id |
| Update File | Change name or expiry |
| Delete File | Soft-delete a file |
| Create from URL | Create a file from a remote URL |
| Copy File / Move File | Duplicate or move between storage contexts |
| Persist File | Clear expiry so a temporary download is kept |
Agents can also load files into short-term memory when configured for file-aware turns.
Limits
- Max size depends on type (for example images ~10MB, PDFs ~50MB, video up to hundreds of MB). Oversized uploads fail.
- The Files list can include files created from other surfaces, not only Add File uploads.
Where files are used
| Place | How |
|---|---|
| Agents / workflows | File blocks; optional load into STM |
| Tables | File / Multi File field values |
| Chat Profiles | Quick reply type File |
| Knowledge Bases | Document uploads into KB storage |
| Chat | User and agent file messages |