add_design_to_board
ChatGPTAdd one published vibrant.design project (from search_designs / browse_designs / find_similar_designs) to a moodboard — globally, or into a group with groupId. The design's cached style analysis is shared instantly — no new AI cost. Fails if that group (or the global area) already shows it. For several at once use add_designs_to_board.
add_designs_to_board
ChatGPTAdd up to 25 published designs in one call — the fast way to assemble a board from search_designs / browse_designs / find_similar_designs results. Pass groupId to fill one section (else they are global). Returns one line per id (added | duplicate | not_found | board_full). A design appears once per group (or once globally); the same design may sit in several groups. The 200-card cap is enforced inside the insert.
add_note
ChatGPTAdd a text note (a brief, a constraint, a requirement) to a moodboard. Notes feed the design direction build: a global note (no groupId) applies to the whole board, a note in a group applies to that group only.
analyze_board_references
ChatGPTEnqueue AI analysis for references that are not analyzed yet — all of them by default, or just referenceIds (same budget as the app's Auto toggle). Gallery designs usually resolve instantly from the shared cache; the user's own uploads run paid analysis under their existing per-user budget. Poll get_build_status until readyToBuild is true.
analyze_design
ChatGPTRun the AI design analysis for one published gallery design — the project page's Analyze button. Already analyzed → free and instant (added to the user's analyzed list). Otherwise it is paid: credits are reserved from the user's balance when it starts and the final cost-plus charge settles when it finishes. ALWAYS call without confirm first: you get status=confirmation_required with the minimum credit cost and the balance — show that to the user and ask before calling again with confirm=true. Errors when the user has no active plan or not enough credits. Poll get_design_status until ready, then get_design_md / get_design_style.
analyze_design_idea
ChatGPTRun the design analysis of one ready idea so its DESIGN.md and build notes exist. Already analysed: free. Otherwise paid (credits reserved on start, cost-plus settled). ALWAYS call without confirm first to get status=confirmation_required with the minimum cost and balance, ask the user, then call again with confirm=true. Poll get_design_idea format=json until analysis=ready.
arrange_board
ChatGPTLay every card out on a clean grid (layout=grid: canvas order; by_kind: gallery designs, then uploads, then notes; boards with groups always by_group). Layout-only — keeps the order of sections, never changes the direction or its staleness.
browse_designs
ChatGPTPage through published designs the way the site's feed does: by category and/or tag (slugs from list_categories), sorted recent | popular | featured, with a keyset cursor. Same card shape as search_designs — chain the ids into add_designs_to_board.
build_direction
ChatGPTSynthesize the board's design direction from all analyzed references (paid AI, under the user's existing budget). Runs in the background — poll get_build_status. The previous direction is archived automatically. Like the app's Build button, this waits for every reference to be analyzed: with analyzeFirst (default) unanalyzed references are queued and the result is status=waiting_for_analysis — poll get_build_status, then call build_direction again once readyToBuild is true.
create_board
ChatGPTCreate a new moodboard for the user. Returns its id — then add designs or notes to it.
create_group
ChatGPTCreate a group — optionally wrapping existing cards/notes/groups (itemIds, which must share one parent). Groups give the board structure the direction build reads: a page holds sections in build order, each section gets its own guidance; a theme weights one dimension; baseline is what exists today. Up to 3 levels, pages only at the top level, up to 40 groups. Anything outside a group stays global and applies to the whole board.
decide_conflict
ChatGPTSave the user's decision for one conflict (from get_board_direction). The decision is authoritative and steers every future build and export.
delete_board
ChatGPTMove a board to Recently deleted (default; restorable for 30 days with restore_board), or erase it with permanent=true — the board and its cards leave the account immediately and cannot be restored. Erasure requires confirmName to equal the board's name. Uploaded files stay in the user's library. Nothing is removed from storage before it has been backed up.
delete_group
ChatGPTDelete a group. withContents=false (default) keeps everything inside (moved up a level, duplicates kept). withContents=true also removes every card, note and sub-group inside — requires confirm=true. Removed rows are soft-deleted and journaled; uploaded files stay in the library.
discover_designs
ChatGPTBrowse vibrant.design the way its feeds do, for inspiration rather than one build: the latest additions, what is trending this week, the most popular, editor-featured, or the weekly picks from the latest newsletter (with why each was picked). Filter by kind (websites, sections, shots = UI shots and motion from the Feed, launch-videos, og-images), style, category, or motion-only (video clips). Cards carry the cover, the video clip URL and duration for motion, creator, live site, styles and analysis state. Read-only and free.
favorite_design
ChatGPTAdd a published vibrant.design project to the user's favourites (or remove it with favorited=false). Idempotent. Favourites are capped at 1000 per account and appear in list_favorites, the Favourites page, and the moodboard import panel.
find_similar_designs
ChatGPTPublished designs that resemble one design (semantic neighbours of its name and description), so a board can be filled with coherent references. Falls back to the newest designs when no neighbours are available — source says which.
fork_board
ChatGPTCopy a board into the user's workspace: cards, notes, layout, uploads (copied into their library, within their storage quota), the built direction and saved decisions. Works on the user's own boards (duplicate), on another user's public board, and on starter boards. The copy starts private. Rate-limited.
get_board
ChatGPTOne board: brief, notes, every card (items — with position, size, version, annotation, its reference id and groupId: null = global, the whole board) and every unique reference with its analysis + token status. Boards with groups also return groups (pages › sections › sub-groups in reading order, up to 3 levels; positions inside a group are relative to it). Use get_board_direction for the direction, get_design_md for the DESIGN.md.
get_board_direction
ChatGPTThe board's resolved design direction. Default section returns summary, rules, decisions, and the implementation prompt — enough to build from. Use section=full for the copy-paste export (large): decisions, direction, and notes are always complete, while reference profiles and the element mapping come one page at a time (page/pageSize, default 25, max 50 references; the header says which page to request next). section=references is paged the same way; summary|rules|decisions|prompt return one part. Any result above 900000 bytes is truncated at a section boundary with a note on what to request. Always states whether the direction is stale and how many conflicts are open.
get_build_status
ChatGPTCheap poll for the board's build state: reference analysis statuses (with readyToBuild — the same gate as the app's Build button), DESIGN.md token-pass progress (analysis.tokens — an extraction in flight holds readyToBuild, missing tokens do not), whether a direction build is running, ready (with staleness + open conflicts), or failed.
get_design_idea
ChatGPTOne generated design idea. format=prompt (default): a self-contained build prompt with the image URL (look at it first), the exact copy, the intended spec, the analysis when available and implementation rules. format=design_md: the DESIGN.md (only after analysis). format=json: the idea's fields. The image is the user's own design: implement it faithfully.
get_design_md
ChatGPTA design-system file in the open DESIGN.md format (Google Labs spec: YAML token front matter + Overview/Colors/Typography/Layout/Elevation & Depth/Shapes/Components/Do's and Don'ts sections, plus Motion, Imagery, Decisions, Sources). Three targets — boardId alone: the whole board (save verbatim as ./DESIGN.md at the repo root; saved decisions are authoritative, open conflicts are marked unresolved); boardId + referenceId|itemId: one reference/node (save as docs/design/<slug>.DESIGN.md); projectId alone: any analyzed published gallery design from the shared cache — the same file as "Copy design.md" (requires an active plan; list_analyzed_designs lists the user's own, analyze_design analyzes a new one). Token values marked inferred are estimates — verify them against the media links in Evidence/Sources. The result is the raw file, ready to write to disk.
get_design_status
ChatGPTCheap check of one published design's shared AI analysis: ready (copy it now), analyzing (poll again in a few seconds), error (the last run failed — analyze_design retries it), or none (never analyzed — analyze_design, after the user confirms the credit cost). Reading is free.
get_design_style
ChatGPTThe build notes of an analyzed published design — the same text as "Copy build notes" on vibrant.design: summary, palette, tags, rules for layout/typography/color/spacing/surfaces/imagery/motion, how to build it, and public media links. Pair with get_design_md for the DESIGN.md file. Requires an active plan; never starts new AI work — if the design is not analyzed yet, use analyze_design (after the user confirms the credit cost).
get_direction_version
ChatGPTThe full archived direction and its rendered implementation prompt for one history entry id (from list_direction_history).
get_reference_style
ChatGPTThe cached style profile for a single reference (accepts referenceId, itemId, or projectId): palette, tags, rules per dimension, how-to-build notes, and public media links.
list_analyzed_designs
ChatGPTThe designs this user analyzed with AI (project page, board or analyze_design), newest first — the same list as vibrant.design/dashboard/analyzed. Each entry has status ready | analyzing | error | none; ready ones can be copied with get_design_md (DESIGN.md) and get_design_style (build notes). Page with cursor.
list_boards
ChatGPTThe user's moodboards with item counts and each board's design-direction state (none | building | ready | error). Large boards are read page by page: get_board_direction section=full|references take page/pageSize (25 references per page by default).
list_categories
ChatGPTThe gallery's taxonomy: categories (what a design is — landing page, portfolio, dashboard…) and tags grouped by context (style, colour, interaction…). Use the slugs with browse_designs.
list_design_ideas
ChatGPTGenerated design ideas (images of one website section with real copy) from the user's Create chats on vibrant.design, newest chats first: id, number, title, status, signed image URL and whether it is analysed. Pass chatId for one chat; otherwise the most recent chats are scanned. Read one with get_design_idea.
list_direction_history
ChatGPTArchived previous builds of this board's design direction, newest first.
list_favorites
ChatGPTThe designs this user has hearted on vibrant.design, newest first, in the same card shape as search_designs. Page with cursor. Add any of them to a board with add_design_to_board.
list_starter_boards
ChatGPTAdmin-curated template boards anyone can fork to get started (read-only otherwise). Empty while the feature is off.
move_to_group
ChatGPTMove cards, notes or groups into a group (groupId) or out to the board (groupId=null → global). Each move is checked: depth ≤ 3, pages stay top level, no group inside itself, one copy of a design per group. Refused moves are listed with a reason; the rest are applied.
remove_item
ChatGPTTake a card off the canvas. The card is kept for board restore/history and any uploaded file stays in the user's library — nothing is deleted from storage.
reopen_conflict
ChatGPTRemove the saved decision for one conflict so the next build treats it as open again.
restore_board
ChatGPTBring a trashed board (delete_board without permanent) back. Boards erased with permanent=true cannot be restored.
search_designs
ChatGPTFull-text search over vibrant.design's published projects (websites, sections, components). Returns cards with cover images and the shared AI analysis state (analysis: ready | analyzing | error | none; ready designs can be copied with get_design_md / get_design_style). Add results to a board with add_design_to_board.
set_board_visibility
ChatGPTprivate (default): only the owner. public: anyone with the link can open a read-only view (no account needed) and signed-in vibrant.design users can fork it; nobody else can edit. Making a board public requires confirm=true. Going private takes effect immediately for everyone.
suggest_designs
ChatGPTRanked vibrant.design gallery references for what is being built: a whole landing page (omit sections) or specific sections (hero, features, pricing, testimonials, cta, footer, …), optionally in a style and for a brief. One call returns a few options per section — cover image, page link, why it fits, and its analysis state — plus whole-website references for the overall look, the caller's access, and the next call for each analysis state. Read-only and free. Show the options to the user and let them pick before building.
ungroup
ChatGPTRemove a group's frame; its cards, notes and sub-groups move up one level (out of a top-level group they become global), keeping their position. If a card would land next to the same design already there, onDuplicate decides: fail (default — reports them, changes nothing), remove the inner copy, or keep both.
update_board
ChatGPTChange the board's name and/or brief (description). The brief feeds the direction build — editing it makes an existing direction stale until it is rebuilt.
update_group
ChatGPTChange a group's title, brief (description), kind, role (section slug / theme dimension) or collapsed state. Title, brief, kind and role feed the direction build; collapse is layout only.
update_item
ChatGPTEdit a note's title/body, or annotate a design/upload card (title = short label, body = what to take from it). Annotations and notes feed the direction build. Pass expectedVersion from get_board to avoid overwriting a concurrent edit.