Workspace Files

Every Space has a persistent filesystem that agents can read from and write to. You can upload files directly from the Files page to make them available to any agent running in that Space.

---

Uploading Files

1. Open a Space and click Files in the left sidebar.
2. Click Upload (or drag files onto the file browser).
3. Select one or more files from your device.
4. The upload completes automatically. Large files (images, video, audio) upload directly to object storage and appear in the /media folder.

Supported file types: Any file type can be uploaded. Agents can read text-based files (.txt, .csv, .md, .json, etc.) and images directly. Video and audio files are placed in /media for agent pipelines that process media.

Size limits: Small files (under ~5 MB) upload via the standard path. Larger media files use a direct upload to object storage with no practical browser timeout — multi-gigabyte video files are supported.

---

Where Files Live

Location	What goes there
/projects	Code, documents, structured data
/knowledge	Reference material agents read repeatedly
/feed	Incoming data, news, or streaming content
/media	Images, video, and audio uploaded from the Files page

Files uploaded from the root-level Files page are placed under /media/<filename> if they are image, video, or audio files. Other file types are placed at the path you specify or at the root.

---

Agents Reading Workspace Files

Any agent running in the Space can access uploaded files using the Read tool or other filesystem tools. To point an agent at a file:

1. Upload the file via the Files page.
2. In chat, reference it by path: "Analyze the data in /media/report.csv" or "Process the video at /media/campaign.mp4."
3. The agent reads the file and uses it as part of its task.

Files persist across conversations — unlike chat attachments, which are scoped to a single conversation.

---

Chat Attachments vs Files Page

	Chat Attachment	Files Page Upload
Lifespan	Current conversation only	Persists in the Space
Agent access	Automatic in that conversation	Available to any agent in the Space
Best for	One-off analysis	Long-term reference, repeated agent use
Large files	10 MB limit	Unlimited (direct object-storage upload)

Use the Files page for assets agents need across multiple runs — CRM exports, brand assets, large media, or reference documents.

---

Troubleshooting

Upload fails immediately

• Check your internet connection. For very large files, a stable connection is required for the direct upload handshake.
• If the Space is new, wait a few seconds and retry — object storage may still be initializing.

File does not appear in the file browser

• Refresh the Files page after uploading.
• If the upload was interrupted, try again — partial uploads are not committed until complete.

Agent cannot find the file

• Ask the agent: "List all files available to you."
• Verify the path — media files land under /media/<filename>, not at the root.

Large video upload shows a provider configuration error

• The hosted Teamday deployment includes object storage. Self-hosted deployments require Tigris or S3-compatible storage configured with TIGRIS_BUCKET (or S3_BUCKET) and matching access credentials. Contact your operator if you manage your own instance.