Monday nodes using deprecated API-Version

问题场景

用户在 n8n 的工作流里使用 Monday.com 节点的 Board item 资源，执行「Get」「Get Many」「Get by Column Value」等会返回 item 的操作。当目标 item 带有 Subitems 列（子项）或 Connect Boards（关联板）列时，节点虽然能返回 item，但这些列的数据字段为空。用户在 100 多个工作流中依赖该数据，业务因此中断。

报错原文

Monday nodes using deprecated API-Version

{
  "id": "subtasks_mkt4epz0",
  "text": null,
  "type": "subtasks",
  "value": null,
  "column": {
    "title": "Subitems",
    "archived": false,
    "description": null,
    "settings_str": "{\"allowMultipleItems\":true,\"itemTypeName\":\"column.subtasks.title\",\"displayType\":\"BOARD_INLINE\",\"boardIds\":[2065244174]}"
  }
}

作为对比，2026-02-15 之前同样的查询会返回带 linkedPulseIds 的 value：

{
  "id": "subtasks_mkt4epz0",
  "text": null,
  "type": "subtasks",
  "value": "{\"linkedPulseIds\":[{\"linkedPulseId\":2708163991}]}",
  "column": {
    "title": "Subitems",
    "archived": false,
    "description": null,
    "settings_str": "{\"allowMultipleItems\":true,\"itemTypeName\":\"column.subtasks.title\",\"displayType\":\"BOARD_INLINE\",\"boardIds\":[2065244174]}"
  }
}

原因分析

最可能的原因是 n8n 的 Monday.com 节点使用的 Monday API 版本已经废弃（deprecated）。Monday.com 于 2026 年 2 月中旬前后行为发生变化，导致新版 API 不再通过旧的 value 字段返回子项/关联板的关系数据。

Issue 作者用 Postman 验证：把 API-Version 升到 2026-01，并在查询中显式加入 ... on SubtasksValue { display_value subitems { id name } } 和 ... on BoardRelationValue { display_value } 片段后，就能正常取到子项数组。n8n 维护者在复现时也确认：同一个 item 用 cURL 直接请求 Monday API 能返回 subitems，而节点内只返回 value: null，进一步说明问题出在节点侧查询/API 版本，而不是数据本身。

Monday.com 官方当时的建议是「不要用 Monday 节点，改用 HTTP Request」。该结论仅是当时的规避建议，并非 n8n 节点的正式修复说明。

环境排查

• n8n 版本：报错者 npm 版为 1.121.3，本地测试 Docker 版为 2.8.3，Queue 模式 + worker/task runner。
• 运行平台：npm 自托管 / Docker 自托管（Debian），数据库分别为 sqlite 与 Postgres。
• Node.js 版本：22.17.0。
• Monday.com 节点版本：复现使用 Monday.com node version 1 (Latest)，资源 Board item，操作 Get。
• Monday API-Version：确认当前节点实际请求使用的版本；对比手动请求使用的版本（如 2026-01）。
• 查询字段：确认请求是否包含 SubtasksValue / BoardRelationValue 片段，以及是否请求 display_value、subitems。

解决步骤

1. 先用 cURL 或 Postman 直接请求 Monday API，验证同一个 item 在 API 侧能否返回 subitems 与关联板数据。Issue 中使用的查询结构为：query { items (ids: [ITEM_IDS]) { id name created_at state column_values { id text type value ... on BoardRelationValue { display_value } ... on SubtasksValue { display_value subitems { id name } } column { title archived description settings_str } } } }。
2. 请求时把 API-Version 指定为较新版本（参考报错者的测试值 2026-01），并携带正确的 Authorization 头。
3. 如果 API 侧返回正常、而 n8n Monday 节点仍返回 value: null，说明节点查询未包含对应 fragment，属于节点侧问题。可优先尝试的变通方案：在 n8n 中改用 HTTP Request 节点直接调用 Monday GraphQL API，并在查询里保留上述 SubtasksValue / BoardRelationValue 片段。
4. 改用 HTTP Request 时，需要自行实现分页和错误处理，以覆盖原本 Monday 节点自动完成的部分。

验证方法

对同一个包含 Subitems 或 Connect Boards 列的 item 分别执行 n8n Monday 节点和手动/HTTP 请求。如果 HTTP 请求（或升级 API-Version 后）能返回 display_value、subitems 数组等数据，而节点输出仍为 value: null，则问题定位在节点；如果在 n8n 中改用 HTTP Request 节点后能拿到与 cURL 一致的结果，说明变通方案对该场景有效。

参考来源

n8n-io/n8n #26071

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。