# File Uploads Tool - Full Documentation
## Overview
Upload, manage, and retrieve files in Notion. Supports single and multi-part upload modes.
## Workflow
1. `create` - Create an upload session (get file_upload_id)
2. `send` - Send file data as base64 (repeat for multi-part)
3. `complete` - Finalize the upload
4. Use the file_upload_id in page/block content to reference the uploaded file
## Actions
### create
Create a file upload session.
```json
{"action": "create", "filename": "report.pdf", "content_type": "application/pdf"}
```
Multi-part upload (for large files):
```json
{"action": "create", "filename": "video.mp4", "content_type": "video/mp4", "mode": "multi_part", "number_of_parts": 3}
```
### send
Send file data (base64-encoded) to an upload session.
```json
{"action": "send", "file_upload_id": "xxx", "file_content": "<base64-encoded-data>"}
```
For multi-part uploads, specify the part number:
```json
{"action": "send", "file_upload_id": "xxx", "file_content": "<base64-encoded-data>", "part_number": 1}
```
### complete
Complete the upload session.
```json
{"action": "complete", "file_upload_id": "xxx"}
```
### retrieve
Get details about a file upload.
```json
{"action": "retrieve", "file_upload_id": "xxx"}
```
### list
List all file uploads with optional limit.
```json
{"action": "list", "limit": 10}
```
## Parameters
- `file_upload_id` - File upload ID (required for send, complete, retrieve)
- `filename` - File name (required for create)
- `content_type` - MIME type (required for create, e.g., "image/png", "application/pdf")
- `mode` - Upload mode: "single" (default) or "multi_part"
- `number_of_parts` - Number of parts for multi-part uploads
- `part_number` - Part number when sending multi-part data
- `file_content` - Base64-encoded file content (for send)
- `limit` - Max results for list action
