get_project

Fetches a project by id and returns its metadata plus a flattened list of canvas items (id, kind, position, size, text, and a label's auto-size flags). 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",
      "isAutoSizeWidth": false,
      "isAutoSizeHeight": false
    },
    {
      "id": "33cc44dd-...",
      "kind": "ImageChart",
      "chartType": 6,
      "position": { "x": 400, "y": 180 },
      "size": { "width": 400, "height": 300 },
      "fileId": "55ee66ff-..."
    }
  ]
}

For labels and stickies, isAutoSizeWidth / isAutoSizeHeight say whether the item honours its size on that axis. When either is true the item ignores that dimension and grows with its text — so a label reporting a width alongside "isAutoSizeWidth": true is not wrapping at that width. See update_item_property for how to pin it.

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