Skip to main content

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

ParameterTypeRequiredDefaultDescription
projectIdstringYesThe 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-..." }