用途：通过 n8n 的 REST API 管理实例中的工作流、执行记录、凭据、标签、变量和用户，适合自动化运维与集成场景。
认证与配置：所有端点需在请求头携带 X-N8N-API-KEY: $N8N_TOKEN。环境变量包括 N8N_TOKEN（在 Settings → n8n API 生成）和 N8N_BASE_URL（实例基础地址）。所有端点位于 ${N8N_BASE_URL}/api/v1。
主要能力：工作流支持列出、获取、创建、更新、删除、激活/停用及标签管理；执行记录支持列出、获取、重试失败执行、停止运行中执行、删除，可按 workflowId、status（error、success、running、waiting）过滤；标签、变量、凭据支持增删改查，凭据还可获取 schema；用户端点仅限实例所有者；另有安全审计端点。
使用方式：以 curl 调用，例如列出工作流：curl -s "${N8N_BASE_URL}/api/v1/workflows" --header "X-N8N-API-KEY: $N8N_TOKEN"。列表端点最多返回 250 条，用响应中的 nextCursor 翻页。更新工作流为整体替换，需先 GET 再 PUT 完整对象。
限制：REST API 需付费 n8n Cloud 方案或自托管实例，免费试用返回 401；自托管需 n8n ≥ 0.174。凭据值创建后不可读回，只能删除或更新。用户管理需 API key 属于实例所有者。故障排查可运行 zero doctor check-connector --env-name N8N_TOKEN 或 zero doctor check-connector --url ${N8N_BASE_URL}/api/v1/workflows --method GET。