Boards
Les Boards sont la surface de données structurées de Copera. L'API Boards vous permet de lire et d'écrire des enregistrements de façon programmatique : lister les boards et leurs tables, lire et créer des lignes avec des colonnes typées, éditer des cellules rich-text, envoyer, télécharger et retirer des pièces jointes de colonnes fichier, gérer les commentaires de ligne, authentifier des lignes contre des colonnes d'identifiants, et exporter une vue vers un fichier. L’API permet aussi de modifier les pièces jointes, de gérer les commentaires sur les fichiers et de restaurer les lignes depuis la corbeille.
Démarrage rapide
- REST API
- Node.js SDK
- CLI
# List all boards
curl -X GET https://api.copera.ai/public/v1/board/list-boards \
-H "Authorization: Bearer YOUR_API_KEY"
# Get a specific board
curl -X GET https://api.copera.ai/public/v1/board/BOARD_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# List rows in a table
curl -X GET https://api.copera.ai/public/v1/board/BOARD_ID/table/TABLE_ID/rows \
-H "Authorization: Bearer YOUR_API_KEY"
# Create a row
curl -X POST https://api.copera.ai/public/v1/board/BOARD_ID/table/TABLE_ID/row \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"columns": [
{ "columnId": "COLUMN_ID", "value": "Hello" }
]
}'
npm install @copera.ai/sdk
import { CoperaAI } from '@copera.ai/sdk';
const copera = CoperaAI({ apiKey: 'YOUR_API_KEY' });
// List all boards
const boards = await copera.board.listBoards();
// Get board details
const board = await copera.board.getBoardDetails({ boardId: 'BOARD_ID' });
// List tables in a board
const tables = await copera.board.listBoardTables({ boardId: 'BOARD_ID' });
// List rows in a table
const rows = await copera.board.listTableRows({
boardId: 'BOARD_ID',
tableId: 'TABLE_ID',
});
// Create a row
const newRow = await copera.board.createTableRow({
boardId: 'BOARD_ID',
tableId: 'TABLE_ID',
columns: [{ columnId: 'COLUMN_ID', value: 'Hello' }],
});
// List row comments (cursor pagination + visibility filter)
const comments = await copera.board.listRowComments({
boardId: 'BOARD_ID',
tableId: 'TABLE_ID',
rowId: 'ROW_ID',
visibility: 'all',
});
curl -fsSL https://cli.copera.ai/install.sh | bash
# List boards (add --json for machine-readable output)
copera boards list
copera boards list --query "roadmap"
copera boards get <board-id>
# Tables
copera tables list --board <board-id>
copera tables get <table-id> --board <board-id>
# Rows
copera rows list --board <board-id> --table <table-id>
copera rows get <row-id> --board <board-id> --table <table-id>
copera rows create --board <board-id> --table <table-id> \
--data '{"columns":[{"columnId":"<column-id>","value":"Hello"}]}'
Disponible dans
| Public API | CLI | MCP | Copera AI |
|---|---|---|---|
| ✅ Complet | ✅ Complet | ✅ Majorité (pas de markdown de colonne rich-text, pas d'authentification de ligne, pas d'upload/suppression de fichier) | ◑ Lecture seule |
Boards est le seul domaine actuellement exposé à l'assistant Copera AI intégré à l'app, et là il est en lecture seule. Le serveur MCP hébergé couvre le modèle de board complet sauf les endpoints de markdown de colonnes rich-text, le flux authenticate de ligne, et les opérations d'upload/suppression de colonnes fichier.
Suite
- Comment fonctionne un Board — le modèle de données board/table/ligne, types de colonnes et cellules, rich-text et pièces jointes, commentaires de ligne et visibilité, authentification de ligne, filtrage, tri et exports asynchrones.
- Boards dans la référence de l'API — chaque endpoint board, table, ligne, commentaire, authenticate et export avec schémas requête/réponse.