Admin Workflows
server 管理端 workflow CRUD、版本、运行和调试接口。
列出 workflow
列出 workflow
使用指定 UUID 原子创建 server 项目
登录用户或管理员使用本地 `package.json.id` 中的 UUID 创建或恢复同 UUID server 项目。
访问当前项目或关联项目存储
`context.storage.server.kv` 与 `context.storage.server.persistentValue` 共用此 HTTP 入口，
读取系统 token 用量
读取系统 token 用量
读取全局审计日志
读取全局审计日志
从文件初始化 workflow
从文件初始化 workflow
查询最新服务器准备任务
查询最新服务器准备任务
查询服务器准备任务
查询服务器准备任务
上传 workflow 压缩包
上传 workflow 压缩包
读取 workflow 源文件
读取 workflow 源文件
上传项目卡片图片
上传客户端完成 1:1 裁剪后生成的 WebP。调用方必须具备项目管理权限。
更新项目卡片元数据
保存完整的纯视觉 `projectCard`，仅接受图标、图片 URL、图标颜色和背景颜色。
下载可本地化的已发布源码快照
仅返回以 `source` 模式发布、声明支持所选 Desktop 平台且调用方具备源码下载权限的在线版本。`latest` 按平台独立解析；`bundled` 版本不会返回原始 TypeScript/JavaScript。
创建项目组部署计划
为一个 Kanban 根项目及选中的 Workflow 数据源预留精确版本。项目组只包含源码包，
查询项目组部署进度
查询项目组部署进度
上传项目组源码包
上传 `project-group` v1 tar.gz。Server 校验清单、普通文件成员、展开大小、每个项目类型
发布项目组
先发布 included 关联项目，最后发布并激活 Kanban 根版本。发布中断后可以幂等续跑；
查询精确版本的项目依赖状态
查询精确版本的项目依赖状态
下载精确项目组源码
根项目和有权限的 included 依赖按 dependency lock 中的精确版本返回。无权限依赖会被列入
列出项目的通用关联项目
返回当前声明、目标项目名称、对方 alias、对方授予当前项目的规则和双方确认状态。待确认关系不授予 KV 权限。
创建或更新通用项目关系
当前项目必须可管理。若调用方也能管理目标项目，`targetAlias` 必填，Server 在一个事务中更新双方；
删除通用项目关系
能管理目标项目时事务式删除双方声明；否则只删除当前项目一侧。关系权限随当前声明立即失效。
列出源码访问申请与授权
列出源码访问申请与授权
审批源码访问申请
审批源码访问申请
撤销用户的项目源码下载能力
撤销用户的项目源码下载能力
解析短期源码申请链接
解析短期源码申请链接
提交源码下载权限申请
提交源码下载权限申请
读取公开项目卡片图片
读取按内容哈希保存的不可变 WebP；用于项目列表、Desktop 和公开 Embed 展示。
读取 workflow 结构
读取 workflow 结构
读取 Kanban 工作区
读取固定 target 的静态产物目录、HTML 入口、清单、当前用户隔离的命名配置和短期预览 capability。
调用 Kanban 项目数据 Bridge
仅拥有当前项目管理权限的 Server Web 用户可调用。服务端先校验 target 对应 Kanban
订阅 Server Web Kanban 关联项目 revision
以 Server-Sent Events 返回当前直接关联项目的完整 revision 快照和后续变化。Server 按
读取 capability 保护的 Kanban 静态资源
使用工作区接口签发的短期 capability 读取固定版本资源。`assetPath` 可以表示
新建或复制 Kanban 配置
新建或复制 Kanban 配置
重命名 Kanban 配置或保存参数值
重命名 Kanban 配置或保存参数值
删除 Kanban 配置
最后一个配置不可删除；删除活动配置后会选择剩余的第一个配置。
切换活动 Kanban 配置
切换活动 Kanban 配置
使用文件内容预览 workflow 结构
使用文件内容预览 workflow 结构
解析 workflow composer 参数联动
解析 workflow composer 参数联动
读取环境变量配置
读取环境变量配置
保存环境变量配置
保存环境变量配置
读取 Embed 配置
读取 Embed 配置
保存 Embed 配置
保存 Embed 配置
读取 Webhook 配置
读取 Webhook 配置
保存 Webhook 配置
保存 Webhook 配置
重置 Webhook Secret
重置 Webhook Secret
保存 server draft 文件
保存 server draft 文件
克隆 workflow
克隆 workflow
同步项目默认名称和展示声明
把本地 `package.json` 根 `name` 与 `workflowCode.projectInfo` 同步到已绑定项目。
更新 workflow 显示信息
更新 workflow 显示信息
删除 workflow
删除 workflow
发布 workflow 版本
`executionTargets` 省略时沿用当前 draft 的发行策略；显式传入的策略必须与 draft 完全一致，
列出项目成员
列出项目成员
设置项目成员角色
owner 和 manager 可以授予 manager/runner/viewer；该接口不支持转移 owner。
删除项目成员
删除项目成员
列出项目邀请
列出项目邀请
生成项目邀请链接
owner / manager 可生成单次有效、7 天过期的邀请 token。owner 角色不可通过邀请授予。
撤销未接受的邀请
撤销未接受的邀请
查看邀请详情
接受邀请前必须先调用本接口查询 token 是否仍然有效。token 本身就是 bearer 凭据，接口不需要登录即可访问；
接受项目邀请
调用方必须是已登录用户。接受成功后该用户被加入到项目成员表中，对应角色由邀请决定。
更新项目可见性
更新项目可见性
列出项目运行用户统计
列出项目运行用户统计
列出项目运行禁止名单
列出项目运行禁止名单
禁止某用户运行项目
owner 和 manager 不能被加入运行禁止名单。
解除运行禁止
解除运行禁止
列出 workflow 版本
列出 workflow 版本
将指定版本重新上线
将指定版本重新上线
手动下线指定版本
手动下线指定版本
列出 Workflow 定时任务
需要 `schedule.manage` 权限和项目读取权限。仅 Workflow 项目可配置定时任务；
创建 Workflow 定时任务
保存前校验精确已发布版本、入口和入口参数。`latest`、`draft`、Conversation
替换 Workflow 定时任务配置
完整替换可编辑配置并重新计算下一次触发；原创建者身份不会改变。存在 pending、running 或 waiting_for_input fire 时返回 409，避免恢复时改变该 fire 的版本、入口或参数。
删除 Workflow 定时任务
存在 pending、running 或 waiting_for_input fire 时返回 409，计划及 fire 历史保持不变。
立即触发一次 Workflow 定时任务
需要 `schedule.manage`、`runs.create` 和项目运行权限。立即运行仍使用计划固定的
读取 Workflow 定时任务触发历史
读取 Workflow 定时任务触发历史
管理端运行 workflow
Workflow 省略入口时运行目标版本默认入口；Conversation 不接受入口字段。Kanban 调用该接口返回 409 且不创建运行记录。
管理端流式运行 workflow
Workflow 省略入口时运行目标版本默认入口；Conversation 不接受入口字段。
读取项目运行队列配置
读取项目运行队列配置
更新项目运行队列配置
更新项目运行队列配置
调试单个 registry node
单节点只能从所选 Workflow entrypoint 的 registry 中解析；Conversation 继续使用 executor registry 且不接受入口字段。
列出运行记录
列出运行记录
聚合运行统计
聚合运行统计
列出运行中和等待中的任务
列出运行中和等待中的任务
停止项目所有运行中和等待中的任务
停止项目所有运行中和等待中的任务
读取运行详情
读取运行详情
停止运行中的执行
只会取消仍挂在当前 server 进程上的 runner；已完成的 run 会返回当前状态且 cancelled=false。
提交用户输入并恢复等待中的 run
仅当 run 当前状态为 `waiting_for_input` 且 `requestId` 与 `pendingUserInput.requestId`
以流式方式提交用户输入并恢复等待中的 run
与 `POST /api/workflows/{workflowName}/runs/{runId}/user-input` 使用同一组校验规则，
读取运行回放
读取运行回放
列出项目 KV
列出项目 KV
读取单条项目 KV
读取单条项目 KV
列出项目知识库文档
列出项目知识库文档
新建项目知识库文档
新建项目知识库文档
查找项目知识库文档
查找项目知识库文档
读取项目知识库文档的指定行范围
读取项目知识库文档的指定行范围
读取项目知识库文档
读取项目知识库文档
编辑项目知识库文档
编辑项目知识库文档
删除项目知识库文档
删除项目知识库文档
读取项目 token 用量
读取项目 token 用量