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

Files & Drive

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

22 verbs in this family.

• abortFileUpload write Discard an open Files upload and every chunk staged in it, or an open asset upload and every part sent to it.
• beginAssetUpload write Open a resumable upload for a large file you hold on a container or a MachineSync box (a mastered WAV, a long recording, a video), up to 209715200 bytes, which lands in Cloud Files and, for audio,…
• beginFileUpload write To save a photo, video or any finished file, name where it is (a URL, a Cloud file, a Studio asset, an email attachment, or a path on your box); only type bytes for something you generated in the…
• commitFileUpload write Finish a staged Files upload: the chunks are joined in index order and checked against the byteSize and contentSha declared at begin.
• completeAssetUpload write Finish, resume or read back an asset upload from beginAssetUpload.
• 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 writeexternal Save one file into Cloud Files in ONE call, in the folder the person chose, and get back its fileId, name, byteSize, contentType 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, only for bytes you hold (a file at a URL, in Cloud Files, in a Studio app, in an email or on a box needs no chunks: name where it is with saveToFiles or…
• stageFileUploadFromMachine write Save a file that sits on one of your MachineSync boxes (a photo, video, PDF or anything a lane produced or downloaded) into Cloud Files in ONE call, without its bytes passing through the chat.