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

Files & Drive

Workspace files and folders, plus the searchable index of attached drives.

19 verbs in this family.

• abortFileUpload write Discard an open Files upload and every chunk staged in it.
• beginFileUpload write 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.
• commitFileUpload write Finish a staged Files upload: the chunks are joined in index order and checked against the byteSize and contentSha declared at begin.
• createFolder write Create a folder to organize Files.
• deleteFile writedestructive Delete a File permanently.
• deleteFolder writedestructive Delete a folder and everything inside it.
• gatherFiles read Plan a gather across drives: given indexed files, group them by drive and report which drives are plugged in vs.
• getFileContext read Get the full lightweight context for one indexed drive file: metadata plus extracted text / transcript, and whether its drive is plugged in right now.
• indexDrive writeexternal Index a connected drive on one of the user's machines: the MachineSync daemon scans it on-device in tiers (metadata → light → deep) and pushes a lightweight per-file index up, so the drive stays…
• listFiles read List folders, Files, and private voice notes.
• moveFile write Move a File into a different folder, or file it into a Space.
• moveFolderToSpace write File a folder: and everything inside it: into a Space, so the whole tree lives with that project instead of floating unbound.
• readFile read Read what is INSIDE a Cloud File: a CSV/TXT/MD/DOCX document, a PDF's text layer, an audio or video transcript, or an IMAGE (a vision description of what it shows plus any legible text, in…
• renameFile write Rename a File of any kind: a zip, a video, a photo, a document.
• renameFolder write Rename a folder.
• saveToFiles write Save one file you made into Cloud Files in ONE call, in the folder the person chose, and get back its fileId and a link to open it.
• searchFiles read Search everything the user has: their Cloud Files (by filename AND by the text inside them), their private voice notes, and their local drive index: in one call.
• shareFolder writeconsent Request sharing a folder with a Space.
• stageFileUploadChunk write Stage one chunk of an open Files upload: up to 786432 bytes (768 KB), base64-encoded, so a 2 MB file is 3 chunks; smaller chunks work too, with its index (0, 1, 2 ...) and its decoded byteSize.