Docs

Docs son las páginas de texto enriquecido de Copera. La API de Docs te permite explorar el árbol de documentos, crear y eliminar documentos, editar sus metadatos, leer y escribir su contenido como markdown, y buscar en todo lo que puedes acceder.

Inicio 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

Documentación completa del SDK y código fuente

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

Configuración del CLI y referencia completa de comandos

Disponible en

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

La API de Docs y el CLI cubren todas las operaciones; el servidor MCP alojado expone la misma superficie a los clientes de IA. Docs no está expuesto al asistente Copera AI dentro de la app.

Siguiente

• Cómo funcionan los Docs: el modelo de documento título/cuerpo/padre, el modelo de acceso, la exploración del árbol, la lectura y escritura de contenido markdown de forma asíncrona, la gestión de documentos y la búsqueda de texto completo.
• Docs en la referencia de la API: endpoints de árbol, búsqueda, get/create/update/delete y contenido markdown con sus esquemas completos.