Boards

Boards sind Coperas Oberfläche für strukturierte Daten. Die Boards-API erlaubt programmatisches Lesen und Schreiben von Datensätzen: Boards und ihre Tabellen listen, Zeilen mit typisierten Spalten lesen und anlegen, Rich-Text-Zellen bearbeiten, Datei-Spalten-Anhänge hochladen, herunterladen und entfernen, Zeilenkommentare verwalten, Zeilen gegen Credential-Spalten authentifizieren und eine View in eine Datei exportieren.

Quick Start

REST API

# 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" }
    ]
  }'

Node.js SDK

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',
});

@copera.ai/sdk

Vollständige SDK-Dokumentation und Quellcode

CLI

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"}]}'

copera-cli

CLI-Konfiguration und vollständige Befehlsreferenz

Verfügbar in

Public API	CLI	MCP	Copera AI
✅ Voll	✅ Voll	✅ Meist (kein Rich-Text-Spalten-Markdown, keine Zeilen-Authentifizierung, kein File-Upload/Entfernen)	◑ Nur lesen

Boards ist derzeit die einzige Domäne, die dem In-App-Assistenten Copera AI bereitsteht — und dort schreibgeschützt. Der gehostete MCP-Server deckt das volle Board-Modell ab, außer den Rich-Text-Spalten-Markdown-Endpunkten, dem Zeilen-authenticate-Flow und File-Spalten-Upload/Entfernen.

Weiter

• So funktioniert ein Board — Datenmodell Board/Tabelle/Zeile, Spaltentypen und Zellen, Rich-Text und Dateianhänge, Zeilenkommentare und Sichtbarkeit, Zeilen-Authentifizierung, Filterung, Sortierung und asynchrone Exporte.
• Boards in der API-Referenz — jeder Board-, Tabellen-, Zeilen-, Kommentar-, Authenticate- und Export-Endpunkt mit Request-/Response-Schemas.