Whiteboards
Every Whiteboards tool, with the scope it needs, its arguments and the API operation it calls.
7 tools
Archive whiteboards
Changes dataatlas_whiteboards_archive
Archive (default) or restore a whiteboard by id. Owner or workspace admin only. Idempotent per MCP invocation.
- Scope
whiteboards:write- Calls
- Example prompt
- Archive whiteboard wb_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Whiteboard id (cuid). |
archived | boolean | No | true to archive, false to restore. Defaults to true. |
Create whiteboards
Changes dataatlas_whiteboards_create
Create a new (empty) collaborative whiteboard with an optional title and project linkage. Returns the created row. Idempotent per MCP invocation.
- Scope
whiteboards:write- Calls
- Example prompt
- Create a whiteboard called Architecture.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
title | string | No | Whiteboard title. |
projectId | string | No | Optional project to hang the whiteboard off. |
Delete whiteboards
Destructiveatlas_whiteboards_delete
Delete one whiteboard by id. Owner or workspace admin only. Use after confirming the board should be removed. Idempotent per MCP invocation.
- Scope
whiteboards:delete- Calls
- Example prompt
- Delete whiteboard wb_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Whiteboard id (cuid). |
Get whiteboards
Read onlyatlas_whiteboards_get
Return one whiteboard by id, including its persisted Excalidraw scene snapshot and current version. 404 when the id is unknown in this workspace.
- Scope
whiteboards:read- Calls
- Example prompt
- Open whiteboard wb_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Whiteboard id (cuid). |
List whiteboards
Read onlyatlas_whiteboards_list
List the caller-visible collaborative whiteboards, optionally filtered to one project or including archived boards. Returns id, title, owner, projectId, version, and timestamps so an MCP host can pick a board to open or summarise.
- Scope
whiteboards:read- Calls
- Example prompt
- List the whiteboards on project prj_123.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | No | Filter to one project id. |
includeArchived | boolean | No | Include archived whiteboards in the result. Defaults to false. |
Rename whiteboards
Changes dataatlas_whiteboards_rename
Rename one whiteboard by id. Convenience wrapper over update that only touches the title. Idempotent per MCP invocation.
- Scope
whiteboards:write- Calls
- Example prompt
- Rename whiteboard wb_123 to Retro.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Whiteboard id (cuid). |
title | string | Yes | New whiteboard title. |
Update whiteboards
Changes dataatlas_whiteboards_update
Patch a whiteboard by id: rename it, replace its Excalidraw scene snapshot, and/or archive/restore it. Pass ifMatchVersion for optimistic-concurrency-safe writes (409 on version mismatch). Idempotent per MCP invocation.
- Scope
whiteboards:write- Calls
- Example prompt
- Rename whiteboard wb_123 to Q3 Roadmap.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Whiteboard id (cuid). |
title | string | No | |
scene | object | No | Excalidraw-compatible scene snapshot { elements, appState, files }. |
archived | boolean | No | Archive (true) or restore (false) the whiteboard. |
ifMatchVersion | integer | No | Optimistic-concurrency guard: only apply if the stored version matches. |