Files & Attachments
You can attach files to individual chat messages to provide the AI with additional context. Attachments are processed and sent to the AI provider alongside your message.
Uploading Attachments
In the Chat playground:
- Click the attachment icon (paperclip) in the message input
- Select a file from your computer
- The file is uploaded and processed
- Type your message and send
Supported File Types
Common supported categories include:
- Documents — PDF, text, markdown
- Code — Python, JavaScript, TypeScript, etc.
- Images — PNG, JPEG, WebP
- Data — CSV, JSON, XML
File Limits
- Maximum file size depends on the provider
- Multiple files can be attached to a single message
- Files are processed before the message is sent
Attachments vs Project Files
| Feature | Attachments | Project Files |
|---|---|---|
| Scope | Single conversation | All conversations in the project |
| Upload | Per message | Per project |
| Available from | That message only | First message in any project conversation |
Security
- Attachments are tied to the conversation’s workspace
- Cross-tenant access is denied
- Files are processed for AI retrieval with
index_for_retrieval: true
Next Steps
- Projects — Upload files at the project level
- Generated Assets — Files generated by the AI
- Chat API — Send attachments via API