Convert

Convert a tldraw snapshot to hierarchical XML

Converts a tldraw StoreSnapshot into an XML document that encodes the diagram hierarchy. Parent-child relationships are derived from tldraw’s native parentId system: shapes inside a data-shape or frame container appear as nested child elements in the XML.

Every non-arrow element also carries its geometry (x/y parent-local coordinates plus w/h) so spatially-laid-out diagrams (e.g. flowcharts) keep their positions, not just nested ones.

Shape mapping:

data-shape → <entity id name type x y w h> (entity-backed node)
frame → <group name x y w h>
geo shapes → <shape type label x y w h>
arrows → omitted from tree, captured in <connections> with their own label (e.g. a flowchart Yes/No branch)

The snapshot is the object returned by editor.store.getStoreSnapshot() or by the /convert/drawio-to-tldraw endpoint.

POST

convert

tldraw-to-xml

Convert a tldraw snapshot to hierarchical XML

curl --request POST \
  --url https://backend.branch.flowengineering.com/convert/tldraw-to-xml \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'customer: <customer>' \
  --data '
{
  "snapshot": {},
  "name": "<string>"
}
'

import requests

url = "https://backend.branch.flowengineering.com/convert/tldraw-to-xml"

payload = {
    "snapshot": {},
    "name": "<string>"
}
headers = {
    "customer": "<customer>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    customer: '<customer>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({snapshot: {}, name: '<string>'})
};

fetch('https://backend.branch.flowengineering.com/convert/tldraw-to-xml', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "xml": "<string>"
}

Authorizations

X-API-Key

string

header

required

Headers

customer

string

required

Workspace identifier

Body

application/json

snapshot

object

required

A tldraw StoreSnapshot JSON object ({ store, schema }) as returned by editor.store.getStoreSnapshot() or the /convert/drawio-to-tldraw endpoint.

name

string

Optional diagram name used as the root attribute.

Response

200 - application/json

Hierarchical XML string representing the diagram structure

xml

string

Convert a tldraw snapshot to hierarchical XML

curl --request POST \
  --url https://backend.branch.flowengineering.com/convert/tldraw-to-xml \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'customer: <customer>' \
  --data '
{
  "snapshot": {},
  "name": "<string>"
}
'

import requests

url = "https://backend.branch.flowengineering.com/convert/tldraw-to-xml"

payload = {
    "snapshot": {},
    "name": "<string>"
}
headers = {
    "customer": "<customer>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    customer: '<customer>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({snapshot: {}, name: '<string>'})
};

fetch('https://backend.branch.flowengineering.com/convert/tldraw-to-xml', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "xml": "<string>"
}

Quickstart

Examples

Automations

Flow MCP

Endpoints

Convert a tldraw snapshot to hierarchical XML

Authorizations

Headers

Body

Response