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: '# Row description\nOptional markdown content.'
});
console.log(newRow);
{
  "_id": "<string>",
  "rowId": 123,
  "owner": "<string>",
  "table": "<string>",
  "board": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "columns": [
    {
      "columnId": "<string>",
      "value": "<unknown>",
      "linkValue": "<unknown>",
      "lookupValue": [
        {
          "foreignRowId": "<string>",
          "foreignRowValue": "<unknown>"
        }
      ]
    }
  ],
  "description": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.copera.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview

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

Request Body

  • description (optional): Markdown content for the row description. Sets the row’s description on creation.
  • columns (array): Array of column values
    • columnId: The ID of the column
    • value: The value for that column (type depends on column definition)

Asynchronous Description

When description is provided, the row is created synchronously and the description content is queued for asynchronous write. The response returns immediately with the new row; the description body becomes available shortly after.

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
Pattern: ^[0-9a-fA-F]{24}$
tableId
string
required

ObjectId

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

Body

application/json
columns
object[]
required
description
string

Optional markdown content for the row description. Sets the row description on creation.

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
description
string