Skip to main content

​
Introduction

Boards are the central organizing structure for data inside Copera. They group tables, which in turn group rows (records). This page explains how boards work conceptually and how integrations interact with them through the Public API.

​
Board Structure

A board acts as a container for tables, and each table contains its own set of rows.

​
Hierarchy

  • Board → contains Tables
  • Table → contains Rows and Columns
Each table defines a set of columns, and each column determines the format and type of values allowed in the rows of that table.

​
Column Types

Supported column types include: Status, Dropdown, Labels, Checkbox, Text, Link, Date, Email, Phone, Website, Number, Location, Paragraph, Users. These column definitions determine how data is structured inside each row. The Public API supports creating rows using basic values compatible with these column types.

​
How Integrations Access Boards

Integrations do not have access to all boards automatically. To interact with a board:
  • The integration must be granted the appropriate permission scope to access boards.
Once authorized, the integration is able to interact with the board’s content according to its permission scope.

​
Integration Capabilities Inside a Board

Once authorized, an integration can:
  • List all boards to which it has access.
  • Retrieve details of a board using its ID.
  • List tables inside a board.
  • Retrieve basic details of a table.
  • List rows belonging to a table.
  • Create new rows.
  • Read rows from tables they have access to.

​
Automations

Bots (integrations) behave like users in a board. Any action performed by an integration can trigger automations configured for that board. This allows programmatic behavior to integrate seamlessly with user workflows.

​
Developer Mode

A Developer Mode isavailable in Copera to make it easier to work with resource identifiers. This feature will allow copying IDs for:
  • Boards
  • Tables
  • Columns
Developers will be able to copy IDs directly from the interface using contextual interactions.

​
Summary

  • Boards organize tables, which organize rows.
  • Integrations can list boards, tables, and rows, and create new rows.
  • Developer mode simplifies retrieving resource identifiers for integrations.