Skip to content
MockFlow DevelopersGet an API key

Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages.

Updated 9 Nov 20262 min read

Send "type": "timeline".

Create a timeline for visualizing chronological events, milestones, history, evolution, or sequential stages. Use this for simple chronological visualization of events or milestones WITHOUT task management. For project plans with tasks, durations, progress, and assignees, use render_gantt instead.

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

Fields

data
eventsobject[]required

Array of timeline events

Child attributes
idstringrequired

Unique event ID (e.g., "evt_1")

titlestringrequired

Event title

descriptionstringrequired

Detailed event description

datestringrequired

ISO date string (real date for date mode, placeholder for label mode)

labelValuestringrequired

Empty string for date mode, meaningful label for label mode (e.g., "Stage 1", "3300 BCE")

coverTypestring

null, or "image" when this render includes images

coverFileIDstring

null, or when this render includes images: "mfimg::" followed by a description of this event's picture (no text, letters or numbers in it)

settingsobjectrequired

Timeline settings

Child attributes
boardTitlestring

Title of the timeline

themestring

Defaults to transparent.

layoutenum<string>

One of horizontal or vertical. Defaults to horizontal.

labelTypeenum<string>

"date" for chronological events with real dates, "label" for stages/phases/abstract sequences. One of date or label.

Example

{
  "type": "timeline",
  "data": {
    "events": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "description": "string",
        "date": "string",
        "labelValue": "string",
        "coverType": "string",
        "coverFileID": "string"
      }
    ],
    "settings": {
      "boardTitle": "Q4 Launch Planning",
      "theme": "transparent",
      "layout": "horizontal",
      "labelType": "date"
    }
  }
}

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
titlestringrequired
datestringrequired
descriptionstring
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": {
    "title": "Q4 Launch Planning",
    "date": "string",
    "description": "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