Skip to main content
Open

Add Table name/title to the REST API

Related products:Apps & IntegrationsAPI
  • March 5, 2026
  • 1 reply
  • 13 views

David Greenwood
Forum|alt.badge.img

The REST API returns data_table_format items with no title or name field — every table has a visible name in the Miro UI, but developers can't access it programmatically. What we tried:

  1. GET /v2/boards/{id}/items?type=data_table_format — returns tables but no title field. Other item types (sticky notes, shapes, text, cards) all include content/title.
  1. GET /v2-experimental/boards/{id}/tables/{id} — has the title, but returns 403 for standard OAuth apps (boards:read boards:write). No additional scope available to unlock it.
  1. MCP context_explore — returns generic names like "Table 3458764661623371178" instead of real names. Works for frames/docs but not tables.
  1. MCP context_get — the only thing that works. Returns an AI-generated summary where the name appears in prose like titled "Planner Tasks". We extract it with regex.

Why this workaround is bad:

  • ~10-15s latency per table (AI processes all row data just to produce a summary)
  • Non-deterministic output — same table returns different prose each call; sometimes the name isn't mentioned at all
  • Requires regex against natural language (fragile)
  • No way to ask for "just the title" — context_get only accepts a URL
  • Requires a separate OAuth 2.1 flow (DCR + PKCE) just to connect to MCP
  • Tokens expire hourly

We're using an AI content analysis tool as a metadata lookup. The data already exists in the Miro backend — it just needs a field on the REST response. The ask: Add a title field to data_table_format items in the v2 API, or make the experimental tables API accessible to standard OAuth apps.

1 reply

Eca
Mironeer
Forum|alt.badge.img+2
  • Mironeer
  • March 5, 2026

Hi ​@David Greenwood 

Thanks so much for taking the time to submit this Wish List idea. Our team will review this and it’s open for votes and comments. 

For those coming across this idea, if you feel this would be helpful for you or your business, please be sure to vote for it and leave a comment about your use case to help our team scope this request!

Thank you again for helping make Miro better!