Docs

Docs são as páginas de rich-text do Copera. A API de Docs permite que você navegue pela árvore de documentos, crie e exclua documentos, edite seus metadados, leia e escreva seu conteúdo como markdown, e busque em tudo o que você pode acessar.

Início Rápido

REST API

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

# Search documents
curl -X GET "https://api.copera.ai/public/v1/docs/search?q=onboarding" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Read a document's markdown content
curl -X GET https://api.copera.ai/public/v1/docs/DOC_ID/md \
  -H "Authorization: Bearer YOUR_API_KEY"

# Create a document
curl -X POST https://api.copera.ai/public/v1/docs/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "New Doc", "content": "# Hello" }'

Node.js SDK

npm install @copera.ai/sdk

import { CoperaAI } from '@copera.ai/sdk';

const copera = CoperaAI({ apiKey: 'YOUR_API_KEY' });

// Browse the tree (omit parentId for root, set depth to control descent)
const tree = await copera.doc.getDocTree({ depth: 3 });

// Search documents
const results = await copera.doc.searchDocs({ q: 'onboarding' });

// Read a document's markdown content
const { content } = await copera.doc.getDocContent({ docId: 'DOC_ID' });

// Create a document
const doc = await copera.doc.createDoc({
  title: 'New Doc',
  content: '# Hello',
});

// Append to a document's content
await copera.doc.updateDocContent({
  docId: 'DOC_ID',
  operation: 'append',
  content: '\n\nMore content',
});

@copera.ai/sdk

Documentação completa do SDK e código-fonte

CLI

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

# Docs commands require a Personal Access Token
copera docs tree
copera docs tree --parent <doc-id>
copera docs search "keyword"
copera docs get <doc-id>
copera docs content <doc-id>

# Create and update
copera docs create --title "New Doc" --content "Initial content"
copera docs update <doc-id> --content "Replacement content"
copera docs update <doc-id> --operation append --content "More content"
copera docs delete <doc-id> --force

copera-cli

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

Disponível em

Public API	CLI	MCP	Copera AI
✅ Completo	✅ Completo	✅ Completo	—

A API de Docs e a CLI cobrem todas as operações; o servidor MCP hospedado expõe a mesma superfície a clientes de AI. Docs não são expostos ao assistente Copera AI dentro do app.

Próximo

• Como os Docs Funcionam — o modelo de documento title/body/parent, o modelo de acesso, navegação pela árvore, leitura e escrita de conteúdo markdown de forma assíncrona, gerenciamento de documentos e busca full-text.
• Docs na Referência da API — endpoints de tree, search, get/create/update/delete e conteúdo markdown com schemas completos.