Docs

I Docs sono le pagine rich-text di Copera. La Docs API ti consente di sfogliare l'albero dei documenti, creare ed eliminare documenti, modificarne i metadati, leggere e scrivere il contenuto come markdown e cercare su tutto ciò a cui puoi accedere.

Quick Start

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

Documentazione completa dell'SDK e codice sorgente

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

Configurazione CLI e riferimento completo ai comandi

Disponibile in

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

La Docs API e la CLI coprono ogni operazione; l'MCP server hostato espone la stessa superficie ai client IA. I Docs non sono esposti all'assistente Copera AI in-app.

Successivi

• Come funzionano i Docs — il modello documento title/body/parent, il modello di accesso, lo scorrimento dell'albero, lettura e scrittura asincrona di contenuto markdown, gestione documenti e full-text search.
• Docs nell'API Reference — endpoint tree, search, get/create/update/delete e contenuto markdown con schemi completi.