The item type catalog

GET /item-types

Updated 16 Sep 20261 min read

GET/item-typesTry it

Basehttps://api.mockflow.com/v1

Request

curl https://api.mockflow.com/v1/item-types \
  -H "Authorization: Bearer $MOCKFLOW_API_KEY"

const response = await fetch("https://api.mockflow.com/v1/item-types", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MOCKFLOW_API_KEY}`
  }
});

const data = await response.json();

import os, requests

response = requests.get(
    "https://api.mockflow.com/v1/item-types",
    headers={"Authorization": f"Bearer {os.environ['MOCKFLOW_API_KEY']}"},
)

response.raise_for_status()
data = response.json()

Response

{
  "data": [
    {
      "type": "artifact",
      "label": "string",
      "hint": "string",
      "primitive": false,
      "creatable": false,
      "mcpTool": "string"
    }
  ]
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "docsUrl": "https://mockflow.com/developers/concepts/errors#rate_limited"
  },
  "requestId": "req_45d49816999bac40"
}

Every item type, generated from the component registry. No token needed. readback says what a GET on an item of that type returns: exact (the same object the type was created with), unwrapped (one wrapper removed), text (a string under the schema's key), pointer (an S3 pointer and state), parts (drawn as many components, read through the structure) or none.

Authorization

Authorizationstringheaderrequired

Bearer <key>. Any key of the workspace. Create and manage keys in the developer console; what each scope unlocks is on the scopes page.

Response

200 · application/json

dataItemTypeSummary[]

Child attributes

typeenum<string>

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.

labelstring | null

hintstring | null

primitiveboolean

creatableboolean

mcpToolstring | null

readbackenum<string>

One of exact, unwrapped, text, pointer, parts or none.

schemaRefstring

Errors

429rate_limited

Too many requests.

Was this page helpful?