whiteboards

autoDesignWhiteboard

Auto-design a complete, visually polished whiteboard from a natural-language goal using the PREMIUM multi-agent pipeline (the same one the in-app assistant uses): it browses the stencil/icon library, composes the WHOLE board, renders it, critiques the rendered image, and refines — far better than hand-placing shapes. This is the one-shot whole-board designer; it is NOT a conversation (for a deck you can chat with and refine turn by turn use designDeckInWhiteboard, and for a refinable illustration use designIllustrationInWhiteboard). COST + APPROVAL: this costs 50 credits per board (a meeting map from a transcript is priced by its length) and needs the user's explicit approval. Call it FIRST without confirm: it returns the exact cost, the workspace credit balance and a single-use quoteToken, and charges nothing. Show the user the price; only if they agree, call again with the same arguments plus confirm: true and that quoteToken (it works once, for 10 minutes). A confirmed call without the token, or with arguments that changed since the quote, starts nothing and charges nothing: it returns a fresh quote instead. If they decline (or lack credits), build the board directly with the standard whiteboard tools (addWhiteboardElements / insertWhiteboardDiagram / listWhiteboardStencils) at no extra charge. It runs in the BACKGROUND and returns immediately with a sessionId; the board fills in over 1-3 minutes. The 50 credits are refunded automatically if the design fails on our side. Optional designProfile: 'branded-executive' instead builds an ON-BRAND, fully-editable McKinsey-style SLIDE DECK themed by the org's brand kit (palette/fonts) — use it when the user wants polished branded business slides; it builds in-process and the board is ready on return. Optional designProfile: 'illustrated' instead builds an editable-illustration board: pick it for illustrated, image-based, picture-style, richly-drawn or educational explainer boards (e.g. illustrate photosynthesis, an illustrated diagram of the water cycle, a textbook-style visual). It generates a rich text-free vector illustration and overlays real, editable text labels with leader lines on top. It is available to every organisation and costs the same flat 50 credits (credits are the only gate). Optional designProfile: 'image' instead builds a single, polished, on-brand IMAGE board with all the text baked into the picture (no editable shapes): pick 'image' when the user wants a single finished image, poster or infographic they will refine by AI mask edits rather than by moving editable shapes. It is also available to every organisation at the same flat 50 credits.

post/tools/autoDesignWhiteboard

Request

  • Base URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1
  • URL: https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/tools/autoDesignWhiteboard
  • Auth: HTTP bearer

Request body

goalstring required

The board to build, in plain language.

titlestring

Optional board title. If omitted, a clear title is derived from the goal (the board is never left 'Untitled'). When designing into an existing 'Untitled' board, the derived/explicit title replaces the placeholder.

documentIdstring

Optional. An existing whiteboard to design into. If omitted, a new whiteboard is created in projectId.

projectIdstring

The project to create the whiteboard in, when no documentId is given.

confirmboolean

Set true ONLY after the user has approved the quoted cost, and send quoteToken with it. Leave unset/false on the first call to receive the quote: the cost, the balance and a quoteToken.

quoteTokenstring

The quoteToken returned by the call without confirm. Required with confirm: true. It works once, within 10 minutes, and only for the exact request it quoted; a changed request gets a fresh quote and nothing is charged.

designProfile'standard' | 'branded-executive' | 'illustrated' | 'image' | 'agentic' | 'agentic-deck'

Optional. 'standard' (default) = the general multi-agent design. 'agentic' = an AI-chat-style agentic slide composer that drives the whiteboard tools and self-corrects from renders, composing ONE polished slide. 'agentic-deck' = the same agentic composer run over a planned storyline, building a multi-slide deck (each slide on its own frame, tiled left to right). 'branded-executive' = an on-brand, McKinsey-style editable SLIDE DECK themed by the org's brand kit (pair with brandKitId, or omit for the org default). 'illustrated' = an editable-illustration board: a rich text-free vector illustration with real editable text labels and leader lines placed on top. 'image' = a single polished, on-brand IMAGE board with all the text baked into the picture (no editable shapes), which the user then refines with AI mask edits. Every profile is available to every organisation; the flat credit fee is the only gate.

brandKitIdstring

Optional brand kit id (from listBrandKits) to theme a branded-executive deck. If omitted, the org's built-in default is used. Create one from just a logo (or a .pptx/.docx) via createBrandKit.

Response

Tool result (shape varies per tool — refer to the tool's docs for the exact return value).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.