I'mBoard API Docs

A document represents a board document's metadata. Documents are scoped to a specific board and can be linked to one or more meetings.

V1 limitation

The API returns document metadata only. File download is not available in V1.

Endpoints

Method	Path	Description
`GET`	`/api/v1/boards/:boardId/documents`	List documents
`GET`	`/api/v1/boards/:boardId/documents/:documentId`	Get a document

Document Object

{
  "object": "document",
  "id": "60d5ec49f1a2c8b1f8e4e1d1",
  "boardId": "60d5ec49f1a2c8b1f8e4e1a1",
  "title": "Q2 Financial Report",
  "documentType": "financial",
  "meetingIds": ["60d5ec49f1a2c8b1f8e4e1b1"],
  "latestVersionId": "60d5ec49f1a2c8b1f8e4e1d2",
  "mimeType": null,
  "createdByUserId": "507f1f77bcf86cd799439011",
  "createdAt": "2025-06-01T10:00:00.000Z",
  "updatedAt": "2025-06-15T14:30:00.000Z"
}

Fields

Field	Type	Description
`object`	`"document"`	Always `"document"`
`id`	string	Opaque document ID
`boardId`	string	The board this document belongs to
`title`	string	Document title
`documentType`	string \| null	Type classification of the document
`meetingIds`	string[]	IDs of meetings this document is linked to
`latestVersionId`	string \| null	ID of the most recent document version
`mimeType`	string \| null	MIME type of the document content
`createdByUserId`	string	ID of the user who created the document
`createdAt`	string	ISO-8601 timestamp
`updatedAt`	string	ISO-8601 timestamp

List Documents

GET /api/v1/boards/:boardId/documents

Supports filtering by meetingId and documentType. See Pagination, Filtering & Sorting.

Example

curl -s "https://app.imboard.ai/api/v1/boards/BOARD_ID/documents?documentType=financial" \
  -H "Authorization: Bearer imb_pat_YOUR_TOKEN" | jq

Get a Document

GET /api/v1/boards/:boardId/documents/:documentId