Skip to content
Imbrace SDK

Data Boards

Boards are the core data store for CRM pipelines — leads, deals, tasks, or any structured data. Pass board ids in board_ids when creating an AI agent to give it access to that data — see Full Flow Guide §4.

Initialize the client first (see Installation or Quick Start).

Board CRUD

const { data: boards } = await client.boards.list();
const board = await client.boards.get("board_id");


const newBoard = await client.boards.create({ name: "Enterprise Leads" });
await client.boards.update("board_id", { name: "Enterprise Leads 2025" });
await client.boards.delete("board_id");

Reorder

await client.boards.reorder({ order: ["board_id_1", "board_id_2", "board_id_3"] });

Import / Export

// CSV import (multipart/form-data)
const formData = new FormData();
formData.append("file", csvFile);
const result = await client.boards.importCsv("board_id", formData);


// Excel import
const excelForm = new FormData();
excelForm.append("file", excelFile);
await client.boards.importExcel("board_id", excelForm);


// Import progress
const progress = await client.boards.getImportProgress("board_id");


// CSV export
const csv = await client.boards.exportCsv("board_id");


// CSV export via email
await client.boards.exportCsvViaMail("board_id", { email: "user@example.com" });

Note: exportCsvViaMail is TypeScript-only.

Items

const { data: items } = await client.boards.listItems("board_id", { limit: 100 });
const item = await client.boards.getItem("board_id", "item_id");


// createItem uses { fields: [{ board_field_id, value }] }
const lead = await client.boards.createItem("board_id", {
  fields: [
    { board_field_id: "name_field_id",   value: "Acme Corp" },
    { board_field_id: "status_field_id", value: "new" },
    { board_field_id: "value_field_id",  value: 50000 },
  ],
});


// updateItem uses { data: [{ key, value }] } — note `key`, not `board_field_id`
await client.boards.updateItem("board_id", lead._id, {
  data: [{ key: "status_field_id", value: "qualified" }],
});


await client.boards.deleteItem("board_id", "item_id");
await client.boards.bulkDeleteItems("board_id", { ids: ["item_1", "item_2", "item_3"] });

Conflict detection

const { is_conflicted } = await client.boards.checkConflict("board_id", "item_id", { version: 2 });
 
// Get related items from another board
const related = await client.boards.getRelatedItems("board_id", "item_id", "related_board_id");


// Get linked board items by type (Opportunities / Tasks)
const linked = await client.boards.getLinkedBoardItems("contact_board_id", "item_id", "Opportunities");


// Link and unlink
await client.boards.linkItems("board_id", "item_id", "related_board_id", { related_item_ids: ["other_item_id"] });
await client.boards.unlinkItems("board_id", "item_id", "related_board_id", { related_item_ids: ["other_item_id"] });
 
const results = await client.boards.search("board_id", { q: "enterprise" });

Fields

const field = await client.boards.createField("board_id", {
  name: "Deal Value",
  type: "Number",
});
await client.boards.updateField("board_id", field._id, { name: "Contract Value" });
await client.boards.deleteField("board_id", field._id);


// Reorder and bulk update
await client.boards.reorderFields("board_id", { fields: ["field_id_1", "field_id_2"] });
await client.boards.bulkUpdateFields("board_id", { fields: [{ _id: "field_1", name: "Updated" }] });

Segments

// listSegments returns BoardSegment[] directly (no { data } wrapper)
const segments = await client.boards.listSegments("board_id");
const segment = await client.boards.createSegment("board_id", {
  name: "High Value Leads",
  filter: {},
});
await client.boards.updateSegment("board_id", segment._id, { name: "VIP Leads" });
await client.boards.deleteSegment("board_id", segment._id);

Knowledge Hub — Folders

// Search
const folders = await client.boards.searchFolders({ q: "contracts" });


// CRUD
const folder = await client.boards.getFolder("folder_id", { recursive: true });
const newFolder = await client.boards.createFolder({ name: "Contracts", parent_id: "parent_id" });
await client.boards.updateFolder("folder_id", { name: "Renamed" });
await client.boards.deleteFolders({ ids: ["folder_id_1", "folder_id_2"] });


// Contents (folder metadata + subfolders + files)
const contents = await client.boards.getFolderContents("folder_id");

Knowledge Hub — Files

// Search and CRUD
const files = await client.boards.searchFiles({ folderId: "folder_id" });
const file = await client.boards.getFile("file_id");
const newFile = await client.boards.createFile({ name: "report.pdf", folder_id: "folder_id" });
await client.boards.updateFile("file_id", { name: "renamed.pdf" });
await client.boards.deleteFiles({ ids: ["file_id_1", "file_id_2"] });


// Upload and download
const uploaded = await client.boards.uploadFile(formData);
const response = await client.boards.downloadFile("file_id");

Board Files

Upload files attached to board records (not Knowledge Hub).

const formData = new FormData();
formData.append("file", file);
const { url } = await client.boards.uploadBoardFile(formData);


// Alternative endpoint
const { url: url2 } = await client.boards.uploadBoardFileV2(formData);

AI Features

// AI-generated tags
const { tags } = await client.boards.generateAiTags({ text: "Enterprise deal with Acme Corp" });


// Link preview
const preview = await client.boards.getLinkPreview("https://example.com");

External Drive

OneDrive / Google Drive integration for Knowledge Hub.

// Initiate OAuth flow
const { auth_url } = await client.boards.initiateDriveAuth("onedrive");


// List remote folders and files
const folders = await client.boards.listDriveFolders("onedrive");
const files = await client.boards.listDriveFiles("onedrive", { folder_id: "remote_folder_id" });


// Download a remote file
const response = await client.boards.downloadDriveFile("onedrive", { file_id: "remote_file_id" });


// Session status (OneDrive only)
const { status } = await client.boards.getOneDriveSessionStatus();