Drive

Drive is Copera's file storage, organized as a familiar tree of files and folders. The Drive API lets you browse that tree, search for items, read file metadata, download files via signed URLs, create folders, and upload files of any size with a resumable multipart flow.

Quick Start

REST API

# Browse the drive tree (root level)
curl -X GET https://api.copera.ai/public/v1/drive/tree \
  -H "Authorization: Bearer YOUR_API_KEY"

# Search drive items
curl -X GET "https://api.copera.ai/public/v1/drive/search?q=quarterly%20report" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get a time-limited signed download URL for a file
curl -X GET https://api.copera.ai/public/v1/drive/FILE_ID/download \
  -H "Authorization: Bearer YOUR_API_KEY"

# Create a folder
curl -X POST https://api.copera.ai/public/v1/drive/folder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "New Folder" }'

CLI

curl -fsSL https://cli.copera.ai/install.sh | bash

# Drive commands require a Personal Access Token with drive access
copera drive tree
copera drive tree --parent <folder-id>
copera drive search "quarterly report"
copera drive get <file-id>

# Download and upload (the CLI handles the multipart flow for you)
copera drive download <file-id> -o report.pdf
copera drive upload ./report.pdf --parent <folder-id>
copera drive upload ./project/ --parent <folder-id>
copera drive mkdir "New Folder"

copera-cli

CLI configuration and full command reference

Available in

Public API	CLI	MCP	Copera AI
✅ Full	✅ Full	✅ Most (no multipart upload)	—

The CLI covers everything and handles multipart uploads for you (concurrent chunks, configurable size, progress bars). The hosted MCP server exposes the read and folder operations but not the multipart upload flow. Drive is not exposed to the in-app Copera AI assistant.

Next

• How Drive Works — the file/folder tree, the access model and participant roles, browsing and searching, signed-URL downloads, creating folders, and the three-step multipart upload flow.
• Drive in the API Reference — tree, search, get/download, create folder, and the start / presigned-urls / finalize multipart endpoints with full schemas.