Skip to main content

🚀 New Feature: You can now create native Doc Formats via API

  • December 23, 2025
  • 5 replies
  • 95 views
Horea Porutiu
Mironeer
Forum|alt.badge.img+2

Hey everyone! 👋

Just wanted to share a quick update for anyone building integrations that involve documentation or rich text on the board.

We’ve just released new endpoints that let you programmatically Create, Get, and Delete "Doc Formats."

An example of what a Doc Format looks like in Miro.

 

💡 Important distinction: We know the naming can be tricky! These endpoints are for Doc Formats (the native, editable text documents that live on the canvas), not for uploading PDF/DOCX files (which are called "Documents" in the API).

What you can do now:

  • Generate project briefs or specs directly onto a board.

  • Read the content of existing docs to sync with external tools.

  • Clean up old docs programmatically.

The Endpoints:

Here is what a Doc Format looks like (embedded widgets and all!): (Insert your screenshot here)

Check out the full details in the Changelog here.

Let us know if you have any questions or if you start building something cool with it!

    5 replies

    David Greenwood
    Forum|alt.badge.img

    Can you please explain what is meant by “Clean up old docs programmatically.”
    and PS the Changelog link does not work

    Horea Porutiu
    Mironeer
    Forum|alt.badge.img+2
    • Horea Porutiu
    • Author
    • Mironeer
    • December 31, 2025

    Hey ​@David Greenwood 

    For example, you can delete an old doc off the board with the delete endpoint. Sorry about the changelog link, here is the correct one: https://developers.miro.com/changelog/new-endpoints-doc-formats

    The doc format endpoints can be found here.

      Robert Johnson
      Forum|alt.badge.img+13
      • Robert Johnson
      • Volunteer Community Moderator
      • January 1, 2026

      Moderator note: Changelog link updated in original post — it now points to:

      https://developers.miro.com/changelog/new-endpoints-doc-formats

      Volunteer Community Moderator | Visual Thinker | Frame many items at once using MultiFrame.ca
        David Greenwood
        Forum|alt.badge.img

        ​@Horea Porutiu “We are looking to provide an UPDATE endpoint in the future to allow for programmatic content editing. Stay tuned!”
        Game changer 💯 Without it replaced docs have a new ID and i/o links and flows are lost.
        Can you share any likely timeframe for this?

        C
        Forum|alt.badge.img

        Hi @Horea Porutiu,

        We are building an integration that programmatically creates training/deep-dive boards with rich content. When calling POST /v2/boards/{board_id}/docs with contentType: "Html", we receive a 401 "app is not whitelisted" error.

        Our app has boards:read and boards:write scopes enabled. Could you help us get whitelisted for the Doc Format endpoints?

        App details:

        • App Name: OpenClaw Board Creator
        • Client ID: 3458764662783272221
        • Team: Automation Gurus
        • Account: chase.woodard@digital-nomads-llc.com

        We would love to use native Doc Formats instead of text items for our board automation. Thanks!

        Tell Us How You Use Miro on Reddit!

        Terms & ConditionsAccessibility statement