---
slug: agentes/mcp/arquivos/upload-begin
title: "upload_begin"
description: "Reserva cota de armazenamento e devolve um link de envio de uso único; um `PUT` do arquivo pelo terminal conclui o envio."
---

| Ferramenta | Tipo | Descrição |
| :-- | :-- | :-- |
| `upload_begin` | escrita | Reserva cota de armazenamento e devolve um link de envio de uso único; um `PUT` do arquivo pelo terminal conclui o envio. O envio retorna `unchanged: true` se a versão atual já tiver os mesmos bytes, tipo de mídia e nome. No drive, um `name` que já existe na pasta acrescenta uma versão a esse arquivo; `keepBoth: true` guarda um arquivo separado com o mesmo nome. Um cliente que anexa arquivos, como o ChatGPT, passa o anexo em `file`: a Siglata baixa o arquivo e devolve o envio concluído, sem link. |