Drive

Drive è lo storage file di Copera, organizzato come un albero familiare di file e cartelle. La Drive API ti consente di sfogliare quell'albero, cercare item, leggere i metadati dei file, scaricare file via signed URL, creare cartelle e caricare file di qualsiasi dimensione con un flusso multipart resumable.

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

Configurazione CLI e riferimento completo ai comandi

Disponibile in

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

La CLI copre tutto e gestisce gli upload multipart per te (chunk concorrenti, size configurabile, barre di avanzamento). L'MCP server hostato espone le operazioni di lettura e cartelle ma non il flusso di upload multipart. Drive non è esposto all'assistente Copera AI in-app.

Successivi

• Come funziona Drive — l'albero file/cartelle, il modello di accesso e i ruoli participant, browsing e search, download via signed URL, creazione cartelle e il flusso multipart a tre passi.
• Drive nell'API Reference — tree, search, get/download, create folder e gli endpoint multipart start / presigned-urls / finalize con schemi completi.