Docs
Les Docs sont les pages rich-text de Copera. L'API Docs vous permet de parcourir l'arbre des documents, de créer et supprimer des documents, d'éditer leurs métadonnées, de lire et écrire leur contenu en markdown, et de rechercher dans tout ce à quoi vous avez accès.
Démarrage rapide
- REST API
- Node.js SDK
- CLI
# 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" }'
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
Documentation complète du SDK et code source
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
Configuration de la CLI et référence complète des commandes
Disponible dans
| Public API | CLI | MCP | Copera AI |
|---|---|---|---|
| ✅ Complet | ✅ Complet | ✅ Complet | — |
L'API Docs et la CLI couvrent chaque opération ; le serveur MCP hébergé expose la même surface aux clients IA. Les Docs ne sont pas exposés à l'assistant Copera AI intégré à l'app.
Suite
- Comment fonctionnent les Docs — le modèle de document title/body/parent, le modèle d'accès, la navigation dans l'arbre, la lecture et l'écriture asynchrones du contenu markdown, la gestion des documents et la recherche full-text.
- Docs dans la référence de l'API — endpoints tree, search, get/create/update/delete et contenu markdown avec schémas complets.