Drive

Drive é o armazenamento de arquivos do Copera, organizado como uma árvore familiar de arquivos e pastas. A API de Drive permite que você navegue por essa árvore, busque itens, leia metadados de arquivos, baixe arquivos via URLs assinadas, crie pastas e faça upload de arquivos de qualquer tamanho com um fluxo multipart retomável.

Início Rápido

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

Configuração da CLI e referência completa de comandos

Disponível em

Public API	CLI	MCP	Copera AI
✅ Completo	✅ Completo	✅ Quase tudo (sem upload multipart)	—

A CLI cobre tudo e cuida dos uploads multipart para você (chunks concorrentes, tamanho configurável, barras de progresso). O servidor MCP hospedado expõe as operações de leitura e de pasta, mas não o fluxo de upload multipart. Drive não é exposto ao assistente Copera AI dentro do app.

Próximo

• Como o Drive Funciona — a árvore de arquivos/pastas, o modelo de acesso e os papéis de participante, navegação e busca, downloads via URL assinada, criação de pastas e o fluxo de upload multipart em três etapas.
• Drive na Referência da API — endpoints de tree, search, get/download, create folder e os endpoints multipart start / presigned-urls / finalize com schemas completos.