Quick Start

1. Initialize the client

TypeScript

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  accessToken: process.env.IMBRACE_ACCESS_TOKEN,
  env: "stable",
})

Python

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    access_token=os.environ["IMBRACE_ACCESS_TOKEN"],
    env="stable",
)

TypeScript

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  apiKey:         process.env.IMBRACE_API_KEY,
  organizationId: process.env.IMBRACE_ORGANIZATION_ID,
  env:            "stable",
})

Python

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    api_key=os.environ["IMBRACE_API_KEY"],
    organization_id=os.environ.get("IMBRACE_ORGANIZATION_ID"),
    env="stable",
)

Tip

Not sure which credential to use? See Authentication →

---

2. Fetch your boards

Boards are CRM pipelines — leads, deals, tasks, or any structured data. This call requires only your credential.

TypeScript

const { data: boards } = await client.boards.list()

for (const board of boards) {
  console.log(board.id, board.name)
}

Python

boards = client.boards.list()

for board in boards.get("data", []):
    board_id = board.get("_id") or board.get("id")
    print(board_id, board.get("name"))

If you see your boards listed, the SDK is connected and authenticated. An empty list (data: []) just means no boards exist yet — that’s fine, not an error.

---

3. Next steps

The Full Flow Guide walks the four major workflows end-to-end. Jump straight to a section:

• AI Agent + streamChat → Full Flow Guide §1
• Workflows → Full Flow Guide §2
• Knowledge Hub (folders, RAG) → Full Flow Guide §3
• Boards & Items (CRM) → Full Flow Guide §4

For the per-namespace API reference, see Resources.