I'mBoard API Documentation
Agent-first documentation for the I'mBoard REST API. Schemas, recipes, and guides for AI agents and developers.
Welcome to the I'mBoard API documentation. This site serves both human developers and AI agents that integrate with I'mBoard.
For AI Agents
If you're an AI agent discovering I'mBoard's API, start here:
- /llms.txt — Structured index of all documentation
- /llms-full.txt — Full documentation content in a single file
- /openapi.json — Machine-readable OpenAPI 3.1 specification
- /api/ontology/index.json — Board Ontology: full catalog (143 KPIs, tier-labeled), wrapped in
{ version, releasedAt, kpis }. Pin to a release at/api/ontology/v/<version>/index.json. - /api/schema-index — Individual JSON schemas for each resource type
- /api/recipe-index — Pre-built dossier recipes for common workflows
Use API tokens for auth, not JWTs. All endpoints require Authorization: Bearer imb_pat_... header.
For Human Developers
- Quickstart — Get your first API call working in under 2 minutes
- Authentication — Token lifecycle, security, and error handling
- Conventions — Response envelopes, field naming, and pagination
- API Reference — Interactive reference from the OpenAPI spec
Resources
| Resource | Description |
|---|---|
| Boards | Board management |
| Members | Board membership and roles |
| Meetings | Meeting scheduling and lifecycle |
| Documents | Document metadata |
| Reports | Board report generation |
| Dashboards | Dashboard configurations |
| Board Ontology | Full KPI catalog — industry-backed + I'mBoard-authored, tier-labeled, versioned |
Guides
- First API Call — Detailed walkthrough
- Create & Update Meetings — Write operations
- List Board Meetings — Pagination examples
- MCP — install & tool reference — Connect Claude, Cursor, Cline, and other MCP-aware clients