Skip to main content

列出版本

分页查询 Skill 的版本,新版本在前。

接口

GET /api/v1/skills/{skill_id}/versions 分页查询 Skill 的版本,新版本在前。自定义 Skill 返回未删除的全部版本,包含 checking 和 rejected 状态;官方 Skill 仅返回 active 版本。

请求参数

参数位置类型必填说明
skill_idPathstring是Skill ID
pageNoQueryinteger否页码,默认 1,最小 1
pageSizeQueryinteger否单页条数,默认 20,取值范围 1 到 100
pageNo × pageSize 不能超过 10000。

响应

data 为分页对象,items 每项为 SkillVersionDTO。
字段类型说明
itemsarray<SkillVersionDTO>当前页版本列表
totallong版本总数
page_nointeger当前页码
page_sizeinteger单页条数

示例

curl "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/skills/skill_abc123/versions?pageNo=1&pageSize=10" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "items": [
      {
        "id": "skillver_NWQ3YmQ1OTRjNGFmxxxxxx",
        "type": "skill_version",
        "skill_id": "skill_abc123",
        "display_name": "workflow-automation",
        "display_description": "将多个技能串联成自动化工作流",
        "version": "1.0",
        "status": "rejected",
        "created_at": "2026-05-11T09:25:43Z",
        "updated_at": "2026-05-11T09:31:01Z",
        "additional_properties": {
          "error_info": {
            "/index.js": "[Dangerous Tools Without Confirmation] Line 179: ...",
            "/SKILL.md": "[Dangerous Tools Without Confirmation] Line 10: ..."
          }
        }
      }
    ],
    "total": 1,
    "page_no": 1,
    "page_size": 10
  },
  "request_id": "28e054b1-2cc4-4e0f-bac5-0c1395b1d7ae"
}

错误

HTTP 状态码error_code说明
401WORKSPACE_ID_ILLEGAL身份信息缺失或无效
400SKILL_ID_IS_NULLskill_id 为空白
400INVALID_PARAMETERpageNo 或 pageSize 非整数、越界或超出分页范围
500SKILL_NOT_EXISTSkill 不存在、已删除或无权访问