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

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

const tables = await copera.board.listBoardTables('board_id_here');
console.log(tables);
[
  {
    "_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"
          }
        ]
      }
    ]
  }
]

​
Overview

Returns all tables associated with the specified board. Each table contains columns that define the structure of data.

​
Response

Returns an array of table objects with:
  • Table ID and name
  • Associated board ID
  • Column definitions (columnId, label, type, order, options)
  • Timestamps

​
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}$

Response

Default Response

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