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.
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.