---
title: "One item type, with its schema and an example"
method: GET
path: "/item-types/{type}"
tags: ["Items"]
---

# One item type, with its schema and an example

`GET /item-types/{type}`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/item-types/{type}`
- Auth: none required

The JSON schema for that type's `data`, exactly what POST /boards/{boardId}/items validates against, plus an example payload and the types it can be converted to.

## Response `200`

OK

- object
  - `type` 'artifact' | 'audio' | 'calendar' | 'chart' | 'checklist' | 'cloud_architecture' | 'code_block' | 'comment' | 'connector' | 'customer_journey' | 'data_simulator' | 'database_diagram' | 'design' | 'floorplan' | 'flowchart' | 'gantt' | 'image' | 'kanban' | 'knowledge_graph' | 'map' | 'map_regions' | 'markdown' | 'mindmap' | 'model_3d' | 'mood_frame' | 'poll' | 'prototype' | 'reaction' | 'section' | 'shape' | 'spinning_wheel' | 'spreadsheet' | 'sticky_note' | 'storyboard' | 'strategy_map' | 'swimlane' | 'table' | 'text' | 'timeline' | 'tree_diagram' | 'upvote_ideas' | 'video' | 'whiteboard' | 'whiteboard_frame' | 'wireframe': Item types, generated from the MockFlow component registry. Primitive types are drawn by the editor; frame types are rich components whose `data` schema is the same one the MCP `render_*` tool accepts.
  - `label` string, nullable
  - `hint` string, nullable
  - `primitive` boolean
  - `creatable` boolean
  - `mcpTool` string, nullable
  - `readback` 'exact' | 'unwrapped' | 'text' | 'pointer' | 'parts' | 'none'
  - `takesRecords` boolean: Whether POST /boards/{boardId}/items/{itemId}/records adds to it. GET /item-types/{type} has the record's schema as `record`.
  - `schemaRef` string
  - `convertibleTo` ItemType[]
  - `schema` object
  - `example` object
  - `docsUrl` string, uri

## Other responses

- `404`: The resource does not exist or the token cannot see it.
- `429`: Too many requests.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)