startedAfter/startedBefore listed as GET /executions params but rejected with “Unknown query parameter”

快速结论：这是 n8n 公开 API 文档与接口实现不一致导致的问题。GET /api/v1/executions 接口实际并不接受 startedAfter/startedBefore 查询参数，调用时会返回 400 错误；该问题已在 n8n 2.37.0 版本中修复。优先升级 n8n 到 2.37.0 或更高版本。

适用环境：n8n 2.35.4（Docker/Cloud），Node.js 24.18.1，SQLite 数据库，常规执行模式（executionMode: regular），n8n Cloud 托管。

最快修复方案：将 n8n 升级到 2.37.0 或更高版本，官方确认该版本已修复问题。

注意事项：官方回复仅确认 2.37.0 已修复，未说明修复方式是接口开始接受参数还是文档移除了错误说明。如果升级后依然想按文档使用这些参数，需要实际验证接口行为是否改变。

问题场景

用户按照 n8n 公开 API 文档（docs.n8n.io/connect/n8n-api/execution）调用 GET /api/v1/executions 接口，并携带文档中标注为可选参数的 startedAfter 或 startedBefore 作为查询字符串参数，结果接口返回 400 错误。用户请求示例：GET https://<instance>/api/v1/executions?status=error&limit=250&startedBefore=2026-08-27T11:37:30.778Z。

报错原文

400 - {"message":"Unknown query parameter 'startedBefore'"}

使用 startedAfter 参数时同样返回：Unknown query parameter 'startedAfter'。

原因分析

可能原因：n8n 公开 API 文档将 startedAfter/startedBefore 错误地列在了 GET /executions 的查询参数说明中，但接口实现并未定义这两个查询参数。这两个参数实际上属于 POST /executions/stop 请求体（request body），而非 GET /executions 的查询字符串。也就是说，文档展示位置有误，导致用户按文档调用时报错。该问题已在 2.37.0 版本中修复。

环境排查

n8n 版本：2.35.4（若已升级至 2.37.0+，请确认问题是否依然存在）；
部署方式：n8n Cloud（Docker）；
Node.js 版本：24.18.1；
数据库：SQLite；
执行模式：regular（默认）。

解决步骤

确认当前 n8n 版本：在 n8n 设置或实例信息中查看版本号，确认是否低于 2.37.0。
升级 n8n 到 2.37.0 或更高版本（官方确认该版本已修复此问题）。
升级后，再次调用 GET /api/v1/executions，并携带 startedBefore 或 startedAfter 参数测试。
如果升级后仍然报错，可先移除这两个参数，改用其他方式过滤执行记录（例如通过 status、limit 等已支持的参数），并等待后续版本进一步修复。

验证方法

升级到 2.37.0+ 后，使用有效的 API Key 调用 GET /api/v1/executions?status=error&limit=250&startedBefore=2026-08-27T11:37:30.778Z，不再返回 “Unknown query parameter” 错误，即表示问题已解决。同时可核对公开 API 文档中该参数的说明位置是否已更正。