prepare_upload
Creates a direct upload target for a named file and size, with optional SHA-256 for instant upload; use another HTTP-capable tool to send the file bytes.
Instructions
Create a direct upload target. Optional SHA-256 enables instant upload; bytes must be sent by the agent using another HTTP-capable tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | target file name | |
| size | Yes | file size in bytes | |
| sha256 | No | optional lowercase SHA-256; enables instant upload | |
| parent_id | No | destination folder UUID; omit for root | |
| transport | No | auto, single_put, or multipart | |
| parent_path | No | absolute parent folder path instead of parent_id | |
| content_type | No | MIME type | |
| idempotency_key | No | stable retry key, maximum 128 characters |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| node | No | ||
| sha256 | No | ||
| status | Yes | ||
| failure | No | ||
| put_url | No | ||
| part_size | No | ||
| part_urls | No | ||
| upload_id | No | ||
| expires_at | No | ||
| total_parts | No | ||
| uploaded_parts | No |