MOmockflow
Items

Convert an item to another type

Mida rebuilds the item's content as the target type and, once the new item has landed, deletes the source unless keepSource is true. See convertibleTo on GET /item-types/{type} for sensible targets.

post/boards/{boardId}/items/{itemId}/convert

Request

  • Base URL
    https://api.mockflow.com/v1
  • Auth
    HTTP bearer

Request body

callbackUrlstring uri

Optional. When the job this request starts finishes or fails, a short body is POSTed here once: { eventId, status, boardId, boardUrl, imageUrl }, where status is succeeded or failed and imageUrl is a picture of what the job drew, or null. Signed with the workspace's callback secret (GET /webhooks/callback-secret). https to a public host. The full job is on GET /jobs/{jobId}.

to'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' required

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.

keepSourceboolean

Example request

{
  "callbackUrl": "https://hooks.zapier.com/hooks/standard/123/abc"
}

Response

Conversion started. The Job's result carries the new item id and convertedFrom.

idstring
kind'item.create' | 'item.update' | 'item.delete' | 'item.batch' | 'item.record' | 'ai.generate' | 'ai.modify' | 'skill.apply' | 'board.export'
status'queued' | 'running' | 'succeeded' | 'failed'
progressinteger
messagestring

Human readable progress, for example "Placing kanban".

errorError (unresolved $ref)
createdAtstring date-time
finishedAtstring date-time nullable
callbackUrlstring nullable

Where the job's result is POSTed

Changes

No recorded changes to this operation across all 1 revision of this API.