get_project
Fetches a project by id and returns its metadata plus a flattened list of canvas items (id, kind, position, size, text). The item ids in the result feed update_item_property, delete_item, connect_items, and style_item.
Tool name: get_project
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
projectId | string | Yes | — | The project (map) id, e.g. from list_projects. |
Returns
Project metadata and the flattened item list. Container items are recursed into, so nested items appear in the same flat list:
{
"projectId": "a1b2c3d4-...",
"mapId": "a1b2c3d4-...",
"rootContainerId": "f0e1d2c3-...",
"tenantId": 42,
"idOfLastEvent": 1337,
"itemCount": 2,
"items": [
{
"id": "11aa22bb-...",
"kind": "LabelChart",
"chartType": 1,
"position": { "x": 100, "y": 200 },
"size": { "width": 240, "height": 48 },
"text": "Q3 Goals"
},
{
"id": "33cc44dd-...",
"kind": "ImageChart",
"chartType": 6,
"position": { "x": 400, "y": 180 },
"size": { "width": 400, "height": 300 },
"fileId": "55ee66ff-..."
}
]
}
For image and vector items, fileId is the stored file id — pass it (or the item id) to get_image_data to download the bytes.
Example
"What's on the Product Roadmap board?"
{ "projectId": "a1b2c3d4-..." }