列出 Skill 版本

按版本号倒序返回技能的全部版本。status=rejected 的版本会附带 additional_properties.error_info，按文件路径列出安全审查问题。仅 active 可挂载。

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /skills/{skill_id}/versions

按版本号倒序返回。每项含 version、status、created_at。

Query 参数

请求示例

curl "$AGENTSTUDIO_URL/skills/skill_xxx/versions?limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

for sv in client.skills.versions.list("skill_xxx", limit=20):
    print(sv.version, sv.created_at)

CursorPage<SkillVersion> versions = client.skills().listVersions(
    "skill_xxx", SkillListParam.builder().limit(20).build());
for (SkillVersion sv : versions.getData()) System.out.println(sv.getVersion() + " " + sv.getCreatedAt());

响应示例

{
  "data": [
    {
      "id": "skillver_xxx",
      "skill_id": "skill_xxx",
      "type": "skill_version",
      "name": "pdf3.0",
      "description": "从 SKILL.md 解析的描述",
      "version": "1.1",
      "status": "active",
      "created_at": "2026-06-16T08:12:47+00:00",
      "updated_at": "2026-06-16T08:14:30+00:00"
    },
    {
      "id": "skillver_xxx",
      "skill_id": "skill_xxx",
      "type": "skill_version",
      "name": "pdf3.0",
      "description": "从 SKILL.md 解析的描述",
      "version": "1.0",
      "status": "rejected",
      "created_at": "2026-06-16T07:56:03+00:00",
      "updated_at": "2026-06-16T07:57:42+00:00",
      "additional_properties": {
        "error_info": {
          "/index.js": "[Dangerous Tools Without Confirmation] Line 179: ...",
          "/SKILL.md": "[Dangerous Tools Without Confirmation] Line 10: ..."
        }
      }
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

响应包含 data（Skill Version 对象数组）与 next_page。Skill Version 对象字段如下：

Skill Version 对象字段