File
Updated at:
Files are standalone resources. Once uploaded, a file can be mounted into multiple session sandboxes for tools to read and write, or passed to the agent as message content (image, audio, attachment).
Quotas and status
- Direct upload size limit per file: 10 MB. Workspace total capacity: 100 GB. Retention: 30 days; files past retention may be cleaned up automatically.
- After upload, files go through security review. The
statusfield takes the valueschecking/available/rejected/type_rejected. Onlyavailablefiles can be mounted into a session or referenced as message content. - When mounted into a session sandbox, the server makes an internal copy and generates a new
file_id. The copy carriesscope: {"type": "session", "id": "sesn_..."}in its metadata and is visible only to that session.
File operations
Operation | Endpoint | Description |
|---|---|---|
| Direct | |
| Query file metadata and review status (does not include content). | |
| Returns the raw binary stream of the file (only files with | |
| Paginated list of files in the workspace, with optional filtering by session ID. | |
| Hard delete; internal copies already mounted into sessions are unaffected. |
Is this page helpful?