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

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

const newRow = await copera.board.createTableRow({
  boardId: 'board_id_here',
  tableId: 'table_id_here',
  columns: [
    {
      columnId: 'column_id_1',
      value: 'Value 1'
    },
    {
      columnId: 'column_id_2',
      value: 'Value 2'
    }
  ],
  description: 'Optional row description'
});
console.log(newRow);
{
  "_id": "<string>",
  "rowId": 123,
  "owner": "<string>",
  "table": "<string>",
  "board": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "columns": [
    {
      "columnId": "<string>",
      "value": "<unknown>"
    }
  ]
}

Overview

Creates a new row (record) in the specified table with optional description and column values.

Request Body

  • description (optional): A text description for the row
  • columns (array): Array of column values
    • columnId: The ID of the column
    • value: The value for that column (type depends on column definition)

Response

Returns the newly created row object with generated ID and timestamps.

Authorizations

Authorization
string
header
required

Bearer token

Path Parameters

boardId
string
required

ObjectId

Required string length: 24
tableId
string
required

ObjectId

Required string length: 24

Body

application/json
columns
object[]
required
description
string

Response

Default Response

_id
string
required
rowId
number
required
owner
string
required
table
string
required
board
string
required
createdAt
string
required
updatedAt
string
required
columns
object[]
required