Skip to main content
GET
/
public
/
v1
/
board
/
{boardId}
/
table
/
{tableId}
Node.js SDK
import { CoperaAI } from '@copera.ai/sdk';

const copera = CoperaAI({
  apiKey: 'your-api-key-here'
});

const table = await copera.board.getBoardTable({
  boardId: 'board_id_here',
  tableId: 'table_id_here'
});
console.log(table);
{
  "_id": "<string>",
  "name": "<string>",
  "board": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "columns": [
    {
      "columnId": "<string>",
      "label": "<string>",
      "type": "<string>",
      "order": 123,
      "options": [
        {
          "optionId": "<string>",
          "order": 123,
          "label": "<string>",
          "color": "<string>",
          "statusGroup": "TODO"
        }
      ]
    }
  ]
}

Prerequisites

  • Valid API key with board read permissions
  • Board ID and Table ID

Parameters

  • boardId: The board containing the table
  • tableId: The specific table to retrieve

Response

Returns table details including column definitions and metadata.

Column Options

For columns of type STATUS, DROPDOWN, or LABELS, an options array is included with each option containing:
  • optionId: Unique identifier for the option
  • label: Display label for the option
  • color: Color code (e.g., RED, BLUE, GREEN)
  • order: Sort order of the option
  • statusGroup: Status group classification (TODO, IN_PROGRESS, DONE) - only for STATUS columns

Authorizations

Authorization
string
header
required

Bearer token

Path Parameters

boardId
string
required

ObjectId

Required string length: 24
Pattern: ^[0-9a-fA-F]{24}$
tableId
string
required

ObjectId

Required string length: 24
Pattern: ^[0-9a-fA-F]{24}$

Response

Default Response

_id
string
required
name
string
required
board
string
required
createdAt
string
required
updatedAt
string
required
columns
object[]
required