Skill

列出 Skill 版本

列出技能所有版本

GET

/api/v1/agentstudio/skills/{skill_id}/versions

cURL

curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/skills/{skill_id}/versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "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"
}

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

查询参数

integer

默认值20

每页数量，最大 100

取值范围：x <= 100

string

首次不传，后续传上一次响应的 next_page

响应

200-application/json

object[]

显示子属性

string

版本 ID，格式 skillver_xxx

string

所属技能 ID

string

固定为 skill_version

string

从该版本 zip 包内 SKILL.md 解析得到

string

从该版本 zip 包内 SKILL.md 解析得到

string

版本号，由服务端生成

enum<string>

扫描状态，仅 active 可挂载

可选值：checking,active,rejected

string

创建时间，ISO 8601

string

最近更新时间，ISO 8601

object

仅 status=rejected 时返回，含 error_info：按 zip 包内文件路径列出的安全审查问题

显示子属性

object

键为 zip 包内文件路径，值为该文件的安全审查问题列表

string

下一页游标，传入下次请求的 page 参数

string

本次请求的唯一标识

cURL

curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/skills/{skill_id}/versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "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"
}