← Back to Documentation

Files

Every worker has a Files tab: a filesystem where the files your workers create are collected, and where you can upload, organize, view, and download your own.

What lands here

Files a worker produces — generated PDFs, spreadsheets, images, and other document-utility output — appear automatically under that worker's Files tab. You can also upload your own files for a worker to reference.

  • Maximum file size: 50MB per file.
  • Files are private to your organization and stored securely.
  • Owned files (created by or uploaded for this worker) and files shared with the worker are shown separately.

Folders

Organize files into nested folders. Use “New folder” to create one in the current location, click a folder to open it, and use the breadcrumb to navigate back up. Folders can be renamed, and deleting a folder moves its files up to the parent folder rather than deleting them.

Move a file into a folder from its detail panel using the “Move to folder” picker.

Uploading & downloading

Use “Upload” to add one or more files to the current folder. Select any file to download it, delete it, or share it with other workers in your organization.

Viewing files inline

Text, Markdown, HTML, JSON, CSV, and XML files can be viewed in the browser without downloading. Markdown and HTML files include a Code ↔ Preview toggle: switch between the raw source and the rendered result. Previews render inside a sandboxed frame so they can't run scripts against the app.

In the API

Files and folders are fully available over the REST API (scopes files:read / files:write):

GET/v1/files?workerId=&folderId=List a worker's files
POST/v1/filesUpload a file (base64) for a worker
POST/v1/files/upload-urlPresigned direct-to-S3 upload for large files (then /confirm)
GET/v1/files/{id}/contentDownload raw bytes
DELETE/v1/files/{id}Delete a file
GET/v1/folders?workerId=List folders
POST/v1/foldersCreate a folder

SDK & MCP

The TypeScript SDK exposes cw.files.upload / list / download / delete and cw.files.createFolder. The MCP server exposes file_upload, files_list, file_get, file_delete, folders_list, and folder_create so agents can save and organize files directly.