# MockFlow developers

> Every page below has a Markdown sibling at the same URL with .md appended.

- [Core concepts](https://mockflow.com/developers/concepts): Errors, pagination, rate limits, idempotency, versioning and scopes.
- [Errors](https://mockflow.com/developers/concepts/errors): One error envelope, eight codes, and the request id to quote when you ask about one.
- [Idempotency](https://mockflow.com/developers/concepts/idempotency): Send an Idempotency-Key on a write and a retry cannot create a second one.
- [Pagination](https://mockflow.com/developers/concepts/pagination): Every list is cursor paginated. Follow nextCursor until hasMore is false.
- [Rate limits](https://mockflow.com/developers/concepts/rate-limits): A per key allowance, counted in a sliding minute, reported on every response.
- [Scopes](https://mockflow.com/developers/concepts/scopes): What each scope unlocks, taken from the operations that require it.
- [Versioning](https://mockflow.com/developers/concepts/versioning): Dated versions. A key keeps the contract it was made against until you move it.
- [API reference](https://mockflow.com/developers/reference): Every endpoint of the MockFlow Boards API, generated from the OpenAPI contract.
- [AI](https://mockflow.com/developers/reference/ai): Generate, modify and ask questions about board content with Mida.
- [Ask Mida about the board](https://mockflow.com/developers/reference/ai/ai-ask): POST /boards/{boardId}/ai/ask
- [Generate items from a prompt](https://mockflow.com/developers/reference/ai/ai-generate): POST /boards/{boardId}/ai/generate
- [Rewrite one item from an instruction](https://mockflow.com/developers/reference/ai/ai-modify): POST /boards/{boardId}/ai/modify
- [What Mida would build, without building it](https://mockflow.com/developers/reference/ai/ai-plan): POST /boards/{boardId}/ai/plan
- [Mida's review of the board](https://mockflow.com/developers/reference/ai/ai-review): POST /boards/{boardId}/ai/review
- [Boards](https://mockflow.com/developers/reference/boards): A MockFlow board is an infinite canvas inside a design space.
- [Create a board](https://mockflow.com/developers/reference/boards/create-board): POST /boards
- [Trash or delete a board](https://mockflow.com/developers/reference/boards/delete-board): DELETE /boards/{boardId}
- [Duplicate a board](https://mockflow.com/developers/reference/boards/duplicate-board): POST /boards/{boardId}/duplicate
- [Get a board](https://mockflow.com/developers/reference/boards/get-board): GET /boards/{boardId}
- [The board as text](https://mockflow.com/developers/reference/boards/get-board-outline): GET /boards/{boardId}/outline
- [The board's structure](https://mockflow.com/developers/reference/boards/get-board-structure): GET /boards/{boardId}/structure
- [The board's activity feed](https://mockflow.com/developers/reference/boards/list-activity): GET /boards/{boardId}/activity
- [List boards](https://mockflow.com/developers/reference/boards/list-boards): GET /boards
- [Recently updated boards](https://mockflow.com/developers/reference/boards/list-recent-boards): GET /boards/recent
- [Restore a board from trash](https://mockflow.com/developers/reference/boards/restore-board): POST /boards/{boardId}/restore
- [Rename, lock, reorder or move a board](https://mockflow.com/developers/reference/boards/update-board): PATCH /boards/{boardId}
- [Collaboration](https://mockflow.com/developers/reference/collaboration): Presence and the board's team chat.
- [Who has the board open right now](https://mockflow.com/developers/reference/collaboration/get-presence): GET /boards/{boardId}/presence
- [Team chat history](https://mockflow.com/developers/reference/collaboration/list-chat): GET /boards/{boardId}/chat
- [Post to the team chat](https://mockflow.com/developers/reference/collaboration/post-chat-message): POST /boards/{boardId}/chat
- [Item types](https://mockflow.com/developers/reference/item-types): Every item type the API accepts, its data schema and the MCP tool that renders the same payload.
- [Artifact](https://mockflow.com/developers/reference/item-types/artifact): Turn a small collaborative mini app YOU generate into a live, runnable MockFlow IdeaBoard tile, and get back the board URL.
- [Audio](https://mockflow.com/developers/reference/item-types/audio): Generate sound to listen to - music, a sound effect, speech, voiceover, narration or a jingle - and place it on the board as an audio player component.
- [Calendar](https://mockflow.com/developers/reference/item-types/calendar): Create a calendar with events for schedules, appointments, holidays, and event planning.
- [Chart](https://mockflow.com/developers/reference/item-types/chart): Create charts including pie, bar, line, area, scatter, bubble, and radar charts.
- [Checklist](https://mockflow.com/developers/reference/item-types/checklist): Create a checklist / to-do list of actionable tasks with checkboxes.
- [Cloud architecture](https://mockflow.com/developers/reference/item-types/cloud-architecture): Create cloud/software system architecture diagrams — backend, microservices, deployment, infrastructure, integration or network architecture — for AWS, Azure, GCP, Kubernetes, SAP, or generic syste…
- [Code block](https://mockflow.com/developers/reference/item-types/code-block): Create a syntax-highlighted code block from a snippet of source code.
- [Comment](https://mockflow.com/developers/reference/item-types/comment): A comment pin.
- [Connector](https://mockflow.com/developers/reference/item-types/connector): The connector item type.
- [Customer journey](https://mockflow.com/developers/reference/item-types/customer-journey): Create customer journey maps with stages, activities, and satisfaction metrics.
- [Data simulator](https://mockflow.com/developers/reference/item-types/data-simulator): Create a live, parameterized what-if simulation: a runnable model the user drives with sliders and play/scrub controls, every output recomputing as they move.
- [Database diagram](https://mockflow.com/developers/reference/item-types/database-diagram): Create database diagrams (ER diagrams) showing tables, columns, primary keys, foreign keys, and relationships.
- [Design frame](https://mockflow.com/developers/reference/item-types/design-frame): Create an editable graphic/marketing DESIGN inside a MockFlow IdeaBoard design frame (posters, flyers, banners, social posts, business cards, brand/slide layouts).
- [Flowchart](https://mockflow.com/developers/reference/item-types/flowchart): Create diagrams including: Flowcharts, Sketchy Diagrams, 3D Isometric Diagrams, Bio/Medical Diagrams, Circuit Diagrams, P&ID Diagrams, UML Diagrams, Sketchy UML, Sequence Diagrams, Cloud Isometric…
- [Gantt](https://mockflow.com/developers/reference/item-types/gantt): Create a Gantt chart with project phases and tasks for project planning, scheduling, and milestone tracking.
- [Image](https://mockflow.com/developers/reference/item-types/image): Generate a standalone picture - an illustration, photo, artwork, icon or logo - and place it on the board as an image component.
- [Kanban](https://mockflow.com/developers/reference/item-types/kanban): Create a Kanban board with columns and task cards for project management, sprint planning, and task tracking.
- [Knowledge graph](https://mockflow.com/developers/reference/item-types/knowledge-graph): Create a knowledge graph (bubble network) showing how concepts relate to each other, like an Obsidian graph view.
- [Map](https://mockflow.com/developers/reference/item-types/map): Create maps with location markers (pins) for plotting SPECIFIC INDIVIDUAL PLACES on a real-world map.
- [Map regions](https://mockflow.com/developers/reference/item-types/map-regions): Create a CHOROPLETH map — a real-world map where whole geographic AREAS (countries, states, provinces, continents, world regions) are FILLED with color to encode a value or category.
- [Markdown](https://mockflow.com/developers/reference/item-types/markdown): Create markdown documents with headings, paragraphs, lists, and AI-generated images.
- [Mindmap](https://mockflow.com/developers/reference/item-types/mindmap): Create a mindmap for brainstorming, topic exploration, and hierarchical idea organization.
- [Model 3d](https://mockflow.com/developers/reference/item-types/model-3d): Generate an actual 3D model - an object, character, prop or scene mesh (GLB/GLTF) - and place it on the board as a 3D model viewer component.
- [Mood frame](https://mockflow.com/developers/reference/item-types/mood-frame): Create a mood/inspiration board inside a MockFlow IdeaBoard mood frame: color palette swatches, typography specimens, keyword/mood text tiles, and photographic image tiles.
- [Poll](https://mockflow.com/developers/reference/item-types/poll): Create a poll / voting question where users pick from predefined options.
- [Prototype](https://mockflow.com/developers/reference/item-types/prototype): Turn a self-contained interactive prototype YOU generate into an editable MockFlow IdeaBoard component, and get back the board URL.
- [Reaction](https://mockflow.com/developers/reference/item-types/reaction): The reaction item type.
- [Section](https://mockflow.com/developers/reference/item-types/section): The section item type.
- [Shape](https://mockflow.com/developers/reference/item-types/shape): The shape item type.
- [Spinning wheel](https://mockflow.com/developers/reference/item-types/spinning-wheel): Create a spinning wheel / random picker with labeled segments.
- [Spreadsheet](https://mockflow.com/developers/reference/item-types/spreadsheet): Create spreadsheets with cell data, formulas, and formatting.
- [Sticky note](https://mockflow.com/developers/reference/item-types/sticky-note): The sticky note item type.
- [Storyboard](https://mockflow.com/developers/reference/item-types/storyboard): Create a film/video storyboard with scenes and frames for visualizing stories, movie sequences, commercials, and video content.
- [Strategy map](https://mockflow.com/developers/reference/item-types/strategy-map): Create a STRATEGY MAP — a plan DRAWN ON a real-world map: zones, coverage circles, route arrows, markers and short text notes over real geography.
- [Swimlane](https://mockflow.com/developers/reference/item-types/swimlane): Create swimlane (cross-functional) diagrams with horizontal rows representing actors, departments, or roles, and flowchart nodes positioned within them.
- [Table](https://mockflow.com/developers/reference/item-types/table): Create data tables and grids from CSV-formatted data — structured rows/columns for display (rosters, comparison tables, inventories, directories).
- [Text](https://mockflow.com/developers/reference/item-types/text): The text item type.
- [Timeline](https://mockflow.com/developers/reference/item-types/timeline): Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages.
- [Tree diagram](https://mockflow.com/developers/reference/item-types/tree-diagram): Create a top-down hierarchy tree diagram.
- [Upvote ideas](https://mockflow.com/developers/reference/item-types/upvote-ideas): Create an idea board where users submit and upvote ideas.
- [Video](https://mockflow.com/developers/reference/item-types/video): Generate a short video clip - animation, motion graphics, cinematic or any moving content - and place it on the board as a video player component.
- [Whiteboard](https://mockflow.com/developers/reference/item-types/whiteboard): Create whiteboards for freeform brainstorming AND structured strategy work: sticky notes and sections, named frameworks (SWOT, SCAMPER, Six Thinking Hats, Fishbone, empathy maps, Lean/Business Mode…
- [Whiteboard frame](https://mockflow.com/developers/reference/item-types/whiteboard-frame): Create a whiteboard WRAPPED IN a MockFlow IdeaBoard whiteboard frame (a single framed board component), for brainstorming and strategy canvases: sticky notes, sections, and named frameworks (SWOT,…
- [Wireframe](https://mockflow.com/developers/reference/item-types/wireframe): Convert HTML to an editable UI wireframe inside a MockFlow IdeaBoard wireframe frame.
- [Items](https://mockflow.com/developers/reference/items): Everything placed on a board. A board is addressed as a whole: pages exist in the data model
but are not part of this contract, because a MockFlow Board has one today. Items are created
on, and read from, the board.

Sticky notes, text, shapes, sections, connectors, comment pins, reactions, and the rich frames
such as kanban, mindmap, flowchart or artifact. A comment is an item: one pin holding one thread.

- [Create, move, resize or delete many items in one draw](https://mockflow.com/developers/reference/items/batch-items): POST /boards/{boardId}/items:batch
- [Convert an item to another type](https://mockflow.com/developers/reference/items/convert-item): POST /boards/{boardId}/items/{itemId}/convert
- [Create an item](https://mockflow.com/developers/reference/items/create-item): POST /boards/{boardId}/items
- [Delete an item](https://mockflow.com/developers/reference/items/delete-item): DELETE /boards/{boardId}/items/{itemId}
- [Get an item](https://mockflow.com/developers/reference/items/get-item): GET /boards/{boardId}/items/{itemId}
- [An item's content as numbered lines](https://mockflow.com/developers/reference/items/get-item-text): GET /boards/{boardId}/items/{itemId}/text
- [One item type, with its schema and an example](https://mockflow.com/developers/reference/items/get-item-type): GET /item-types/{type}
- [The item type catalog](https://mockflow.com/developers/reference/items/list-item-types): GET /item-types
- [List items](https://mockflow.com/developers/reference/items/list-items): GET /boards/{boardId}/items
- [Move, resize, replace data or reply](https://mockflow.com/developers/reference/items/update-item): PATCH /boards/{boardId}/items/{itemId}
- [Check a payload without drawing it](https://mockflow.com/developers/reference/items/validate-item-data): POST /item-types/{type}:validate
- [Jobs](https://mockflow.com/developers/reference/jobs): Polling anything that answered with 202.
- [Get a job](https://mockflow.com/developers/reference/jobs/get-job): GET /jobs/{jobId}
- [Me](https://mockflow.com/developers/reference/me): The authenticated user and workspace.
- [Get AI credits](https://mockflow.com/developers/reference/me/get-credits): GET /me/credits
- [Get plan limits](https://mockflow.com/developers/reference/me/get-limits): GET /me/limits
- [Get the current user](https://mockflow.com/developers/reference/me/get-me): GET /me
- [Notification settings](https://mockflow.com/developers/reference/me/get-notification-settings): GET /me/notification-settings
- [My notifications](https://mockflow.com/developers/reference/me/list-notifications): GET /me/notifications
- [Sources Mida can read from](https://mockflow.com/developers/reference/me/list-sources): GET /me/sources
- [Mark a notification read](https://mockflow.com/developers/reference/me/read-notification): POST /me/notifications/{notificationId}/read
- [Change notification settings](https://mockflow.com/developers/reference/me/set-notification-settings): PUT /me/notification-settings
- [Members](https://mockflow.com/developers/reference/members): Who can see a board, and the public link. Sharing itself happens on the space.
- [Get the public link](https://mockflow.com/developers/reference/members/get-public-link): GET /boards/{boardId}/public-link
- [Who can open this board](https://mockflow.com/developers/reference/members/list-members): GET /boards/{boardId}/members
- [Enable, configure or disable the public link](https://mockflow.com/developers/reference/members/set-public-link): PUT /boards/{boardId}/public-link
- [Search](https://mockflow.com/developers/reference/search): Full text search over board titles and item text the token can read.
- [Search boards and items](https://mockflow.com/developers/reference/search/search): GET /search
- [Skills](https://mockflow.com/developers/reference/skills): Saved Mida recipes, public or your team's, and applying one to a board.
- [Generate on a board with a skill](https://mockflow.com/developers/reference/skills/apply-skill): POST /boards/{boardId}/skills/{skillId}/apply
- [Create a skill](https://mockflow.com/developers/reference/skills/create-skill): POST /skills
- [Delete a skill you made](https://mockflow.com/developers/reference/skills/delete-skill): DELETE /skills/{skillId}
- [Have Mida draft a skill](https://mockflow.com/developers/reference/skills/draft-skill): POST /skills/draft
- [Get a skill](https://mockflow.com/developers/reference/skills/get-skill): GET /skills/{skillId}
- [List skills](https://mockflow.com/developers/reference/skills/list-skills): GET /skills
- [Update a skill you made](https://mockflow.com/developers/reference/skills/update-skill): PATCH /skills/{skillId}
- [Spaces](https://mockflow.com/developers/reference/spaces): Design spaces group boards inside a workspace.
- [Share a space with a person](https://mockflow.com/developers/reference/spaces/add-space-member): POST /spaces/{spaceId}/members
- [Create a design space](https://mockflow.com/developers/reference/spaces/create-space): POST /spaces
- [Move a space to trash](https://mockflow.com/developers/reference/spaces/delete-space): DELETE /spaces/{spaceId}
- [Get a space](https://mockflow.com/developers/reference/spaces/get-space): GET /spaces/{spaceId}
- [Get the space's public link](https://mockflow.com/developers/reference/spaces/get-space-public-link): GET /spaces/{spaceId}/public-link
- [List space members](https://mockflow.com/developers/reference/spaces/list-space-members): GET /spaces/{spaceId}/members
- [List design spaces](https://mockflow.com/developers/reference/spaces/list-spaces): GET /spaces
- [Remove a member](https://mockflow.com/developers/reference/spaces/remove-space-member): DELETE /spaces/{spaceId}/members/{email}
- [Restore a space from trash](https://mockflow.com/developers/reference/spaces/restore-space): POST /spaces/{spaceId}/restore
- [Enable, configure or disable the space's public link](https://mockflow.com/developers/reference/spaces/set-space-public-link): PUT /spaces/{spaceId}/public-link
- [Rename or reorder a space](https://mockflow.com/developers/reference/spaces/update-space): PATCH /spaces/{spaceId}
- [Change a member's role](https://mockflow.com/developers/reference/spaces/update-space-member): PATCH /spaces/{spaceId}/members/{email}