Praxis文档
控制台
自动化

列出工作流版本

按语义版本倒序分页列出不可变的 schema 和锁定依赖。

按语义版本倒序分页列出不可变的 schema 和锁定依赖。默认不带源码；仅 expand=source 带完整源码，其它值返回 400。详情接口保持全文。

GET /automation/v1/workflows/{ns}/{name}/versions

鉴权

Authorization: Bearer $PRAXIS_API_KEY

请求字段

参数类型说明
path: nsstring必填；命名空间，存储前转为小写，格式 [a-z0-9][a-z0-9._-]{0,63}；praxis 只读。
path: namestring必填；名称，存储前转为小写，格式 [a-z0-9][a-z0-9._-]{0,63}。
query: limitinteger可选；每页条数，整数 1–100，默认 25。 minimum: 1；maximum: 100
query: cursorstring可选；上一页返回的 next_cursor，不透明字符串；保持原查询条件继续翻页。
query: expand"source"可选；仅接受 source；默认不带源码，其它值返回 400。

示例

SDK 安装与示例环境

先设置以下环境变量，使用你自己的资源：

变量来源
WORKFLOW_NAME创建工作流返回的 name
: "${WORKFLOW_NAME:?Set WORKFLOW_NAME}"
curl --fail-with-body -X GET "https://api.deepraxis.ai/automation/v1/workflows/docs-samples/${WORKFLOW_NAME}/versions" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
import { createAutomationClient } from '@deepractice-ai/praxis-sdk/automation';

function env(name: string): string {
  const value = process.env[name];
  if (!value) throw new Error(`Set ${name}`);
  return value;
}
const automation = createAutomationClient({
  apiKey: env('PRAXIS_API_KEY'),
  baseUrl: 'https://api.deepraxis.ai',
  maxRetries: 0,
  timeoutMs: 90_000,
});
const result = await automation.workflows.versions.list({
  "path": {
    "ns": "docs-samples",
    "name": env("WORKFLOW_NAME")
  }
});
console.log(result);

响应

HTTP 200

Success

application/json

字段类型说明
dataobject[]必填 / 必有；本页的工作流版本（默认不含源码，expand=source 才带），按 semver 降序排列。
data[].idstring必填 / 必有；版本 ID，脚本前缀 scv_，工作流前缀 wfv_。
data[].kind"script" / "workflow"必填 / 必有；编排类型。script 为 TypeScript 脚本，一次执行；workflow 为 YAML 工作流，由步骤组成，可等待事件、定时器或子运行并可暂停。
data[].versionstring必填 / 必有；版本号（semver，已去掉 +build 元数据）。
data[].digeststring必填 / 必有；源码与契约的内容摘要。
data[].sourcestring可选；该版本的完整源码。版本列表默认不返回，需要时加 expand=source。
data[].input_schemaobject必填 / 必有；任意 JSON 对象（键为字符串，值为任意 JSON 值）。
data[].input_schema.*（分支5)object递归 JSON 值。
data[].input_schema.*（分支6)[]null / string / number / boolean / object / JSON[]递归 JSON 值。
data[].output_schemaobject必填 / 必有；脚本从返回类型推导，支持 Promise 解包、Record、交叉类型和 Date（date-time）；推不出时为空 schema，并在 /validate 的 warnings 给出 warning。
data[].output_schema.*（分支5)object递归 JSON 值。
data[].output_schema.*（分支6)[]null / string / number / boolean / object / JSON[]递归 JSON 值。
data[].referencesobject[]必填 / 必有；该版本依赖的动作、平台 API、脚本与工作流。脚本和工作流依赖在发布时锁定到精确版本。
data[].references[].kind"action" / "script" / "workflow" / "platform_api" / "run"必填 / 必有；依赖类型。action 为动作；platform_api 为平台 API 操作；script 为脚本；workflow 为工作流；run 为脚本中 invoke("ns/name") 调用的子运行目标（脚本或工作流，发布时解析）。
data[].references[].namestring必填 / 必有；被依赖对象：动作为 ns/name，平台 API 为操作名，脚本与工作流为 ns/name。
data[].references[].rangestring可选；引用时写的版本范围或标签（npm 规则）；未写时为空。
data[].references[].locked_versionstring可选；发布时锁定的精确版本；仅脚本与工作流依赖有，动作与平台 API 不锁定。
data[].outlinenull / object[]必填 / 必有；工作流的步骤大纲（OutlineNode 数组），由解析器静态生成；脚本为 null。
data[].outline（分支2)[].namestring必填 / 必有；步骤名，即工作流 YAML 中该步骤的键。
data[].outline（分支2)[].referencestring必填 / 必有；该步骤在工作流文档中的 JSON Pointer，例如 /do/0/start；与运行时 Task.reference 一致。
data[].outline（分支2)[].kind"run" / "call" / "wait" / "set" / "for" / "fork" / "try" / "switch" / "emit" / "raise" / "listen" / "do"必填 / 必有；工作流步骤类型。call 调用动作；run 运行子脚本或子工作流；wait 等待时长；set 设置变量；for 循环；fork 并行分支；try 带捕获的块；switch 条件分支；emit 发出事件；raise 抛出错误；listen 等待事件；do 顺序执行的步骤块。
data[].outline（分支2)[].targetstring可选；步骤调用的目标：call 步骤为动作 ns/name，run 步骤为 ns/name@范围；其它类型没有。
data[].outline（分支2)[].waitobject可选；等待步骤的摘要：时长（seconds 或 duration）或等待的事件类型（event）。 不接受额外字段。
data[].outline（分支2)[].wait.untilstring可选；等待结束的绝对时刻，仅在可静态确定时给出；目前大纲不填充该字段。
data[].outline（分支2)[].wait.secondsnumber可选；可静态换算的等待秒数；时长对象与可换算的 ISO 时长均投影到此字段。
data[].outline（分支2)[].wait.eventstring可选；listen 步骤等待的事件类型。
data[].outline（分支2)[].wait.durationstring可选；无法静态换算成秒的原始时长或运行时表达式；不与 seconds 强行换算。
data[].outline（分支2)[].loopobject可选；for 步骤的循环信息 {each, in}。 不接受额外字段。
data[].outline（分支2)[].loop.eachstring必填 / 必有；循环变量名；未指定时为 item。
data[].outline（分支2)[].loop.instring必填 / 必有；被遍历的集合表达式原文。
data[].outline（分支2)[].childrenobject[]可选；嵌套的子步骤（do、fork 分支、try 与 catch 内的步骤）。
data[].outline（分支2)[].children[]object递归 JSON 值。
data[].sdk_versionnull / string必填 / 必有；发布脚本所用的 SDK 版本；工作流为 null。
data[].published_atstring必填 / 必有；发布时间（RFC 3339 UTC）。
data[].published_byobject必填 / 必有；网关注入的主体 {type, id}，表示谁发起或操作；本服务不解析名字，名字由控制台批量解析。 不接受额外字段。
data[].published_by.type"user" / "api_key" / "agent" / "run" / "trigger"必填 / 必有；主体类型。user 为登录用户；api_key 为平台 API Key；agent 为智能体；run 为由运行本身（例如父运行）执行的操作；trigger 为触发器。
data[].published_by.idstring必填 / 必有；主体标识，含义随 type 而定：用户 ID、API Key ID、智能体 ID、运行 ID 或触发器 ID；按不透明字符串处理。
data[].deprecatednull / string必填 / 必有；弃用说明；未弃用为 null。弃用的版本仍可运行，但按范围或标签解析时优先选用未弃用的版本。
data[].deprecated_atnull / string必填 / 必有；弃用时间（RFC 3339 UTC）；未弃用为 null。
data[].deprecated_bynull / object必填 / 必有；执行弃用的主体；未弃用为 null。
data[].deprecated_by（分支2).type"user" / "api_key" / "agent" / "run" / "trigger"必填 / 必有；主体类型。user 为登录用户；api_key 为平台 API Key；agent 为智能体；run 为由运行本身（例如父运行）执行的操作；trigger 为触发器。
data[].deprecated_by（分支2).idstring必填 / 必有；主体标识，含义随 type 而定：用户 ID、API Key ID、智能体 ID、运行 ID 或触发器 ID；按不透明字符串处理。
next_cursornull / string必填 / 必有；下一页游标，原样传给 cursor 参数并保持原查询条件；没有更多页为 null。接口不返回总数。

实测响应

HTTP 200

{
  "data": [
    {
      "id": "wfv_00mv67m6x5409408c354944fa8a960d207eb33c297",
      "kind": "workflow",
      "version": "1.0.0",
      "digest": "ea7352d51087eca0113ee82230848ce1506fd97d27aad4c7b1911e5c4ef9b5fb",
      "input_schema": {},
      "output_schema": {},
      "references": [],
      "outline": [
        {
          "name": "answer",
          "reference": "/do/0/answer",
          "kind": "set"
        }
      ],
      "sdk_version": null,
      "published_at": "2026-10-13T04:57:32.297Z",
      "published_by": {
        "type": "api_key",
        "id": "key_3e00b8984967"
      },
      "deprecated": null,
      "deprecated_at": null,
      "deprecated_by": null
    }
  ],
  "next_cursor": null
}

错误码

HTTP错误码与说明
400INVALID_PARAMS：请求参数、路径、游标或请求体格式无效。
404TARGET_NOT_FOUND：编排目标不存在或类型不匹配。
defaultRFC 9457 automation problem. 429 includes Retry-After.

鉴权错误与通用错误 · 排查时保留响应头 X-Request-Id。

发布工作流版本

从草稿或临时运行源码发布版本，校验定义并锁定依赖。

读取工作流版本

读取精确版本的源码、输入输出契约及弃用说明；版本缺失返回 VERSION_NOT_FOUND。

导出
本页 Markdown本节 Markdown整本 PDF

本页内容

鉴权请求字段示例响应HTTP 200实测响应错误码