Skip to content
MockFlow DevelopersGet an API key

Create charts including pie, bar, line, area, scatter, bubble, and radar charts.

Updated 9 Nov 20262 min read

Send "type": "chart".

Create charts including pie, bar, line, area, scatter, bubble, and radar charts. Only for plotting VALUES: a "chart" that plots nothing and instead shows how people or parts relate (org chart, reporting structure, hierarchy tree) is a diagram — use render_flowchart.

Also available as the MCP tool render_chart. The same payload works through either surface.

Fields

data
componentTypeenum<string>required

Chart type. One of MF_PieChart2, MF_HorizontalLineChart, MF_VerticalBarChart, MF_HorizontalBarChart, MF_AreaChart, MF_ScatterChart, MF_BubbleChart or MF_RadarChart.

chartDatastringrequired

CSV-formatted chart data. For pie: "Label1,Label2\n20,30". For line/bar: "Legends,Series\nJan,100\nFeb,120"

titlestringrequired

Chart title

chartColorsobject[]

ONLY when the user names a color scheme/theme/brand: one entry per data series/slice matching that theme. Omit entirely otherwise (component defaults apply).

Child attributes
legendstring

Series/slice name exactly as it appears in chartData

backgroundColorstring

Hex color like #1B4F72

Example

{
  "type": "chart",
  "data": {
    "componentType": "MF_PieChart2",
    "chartData": "string",
    "title": "Q4 Launch Planning",
    "chartColors": [
      {
        "legend": "string",
        "backgroundColor": "string"
      }
    ]
  }
}

Add one record

POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.

Record fields

record
labelstringrequired
valuenumberrequired
chartTypeenum<string>

What a new chart is drawn as. A chart already on the board keeps its own type. One of bar, horizontal bar, line, area, pie, scatter, bubble or radar.

seriesstring

Which series the value is for, on a chart with more than one; made when there is none by that name. The first series when left out.

keystring

Your own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.

{
  "record": {
    "label": "string",
    "value": 0,
    "chartType": "bar",
    "series": "string",
    "key": "string"
  }
}
Was this page helpful?

Sign in to MockFlow

The same account you use in the app and on the API.

Forgot your password?
or
Continue with GoogleContinue with MicrosoftContinue with Apple