---
title: "upload_begin"
description: "Reserves storage quota and returns a one-time upload link; one shell `PUT` of the file completes the upload."
---

| Tool | Kind | Purpose |
| :-- | :-- | :-- |
| `upload_begin` | write | Reserves storage quota and returns a one-time upload link; one shell `PUT` of the file completes the upload. The upload returns `unchanged: true` if the current version already has the same bytes, media type and name. |