列表 Skill 版本

返回指定 Skill 当前存储版本的描述信息。

GET /api/v1/cloud/skills/{skill_id}/versions

以 data 数组形式返回指定 Skill 当前存储版本的描述信息。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>

​

路径参数

参数	类型	必选	说明
skill_id	string	是	Skill 的唯一标识符

​

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/skills/skill_019e3bba474b73cfaf19eae9b5f5e66d/versions" \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK

{
  "data": [
    {
      "version": "1",
      "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
      "status": "active",
      "content_size": 309,
      "content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
      "created_at": "2026-05-18T15:35:24.248164Z",
      "updated_at": "2026-05-18T15:36:01.767469Z"
    }
  ]
}

​

响应字段

字段	类型	说明
data	array	Skill version 对象数组

SkillVersion 对象：

字段	类型	说明
version	string	版本号（字符串格式，如 "1"、"2"）
skill_id	string	所属 Skill 的 ID
status	string	版本状态：active
content_size	integer	该版本 zip 文件大小（字节）
content_sha256	string	该版本内容的 SHA-256 哈希值
created_at	string	版本创建时间（ISO 8601）
updated_at	string	版本最后更新时间（ISO 8601）

​

错误码

HTTP	type	触发条件
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	Skill 不存在或不再可访问

​

注意事项

• 版本号以字符串形式返回（如 "1"）
• 当前实现返回 active Skill 的当前版本描述
• 通过 PUT /api/v1/cloud/skills/{skill_id} 更新 content 时版本号递增
• 仅更新元数据时版本号不会递增

完整错误信封说明详见 错误参考。

​

相关

Agent 技能

为 Agent 附加领域专业知识。