1. Docs
2. /
3. Tool reference
4. /
5. Files & Drive
6. /
7. beginFileUpload

Files & Drive

beginFileUpload

Begin File Upload

Open a staged upload that files one attachment (a .txt, .pages, .pdf, photo, recording and so on) into Cloud Files, when you hold the file's bytes and the person asked you to keep it.

write

Arguments

• byteSizeintegerrequiredThe whole file's size in bytes (1 to 3000000).
• contentShastringrequiredThe whole file's SHA-256, as 64 hex characters.
• contentTypestringrequiredThe file's MIME type, e.g. "text/plain" or "application/pdf". Send "application/octet-stream" when unsure and the name's extension decides.
• folderIdstringoptionalThe folder the person named (folderId from listFiles). Omit to land the file in their Files root.
• namestringrequiredThe file name with its extension, e.g. "Autumn.pages".

Returns

The registry does not declare a return shape.

Declared limits

• byteSize: minimum -9007199254740991
• byteSize: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• save this attachment to my Cloud
• put these files in Files > Poetry
• store the file I sent in The Cloud

Pair it with

The verbs that finish the job.

• stageFileUploadChunk
• commitFileUpload
• abortFileUpload
• listFiles