Skip to main content
Versions

获取 Skill 版本

根据版本号获取单个 Skill 版本的详细信息。

GET /api/v1/cloud/skills/{skill_id}/versions/{version} 根据版本号获取单个 Skill 版本的详细信息。

请求头

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

路径参数

参数类型必选说明
skill_idstring是Skill 的唯一标识符
versionstring是版本号，仅接受数字时间戳

示例请求

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

示例响应

HTTP 200 OK 
{
  "id": "skillver_019e3bba474b7f10a3c2b4d5e6f70123",
  "type": "skill_version",
  "skill_id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "version": "1759178010641129",
  "name": "my-custom-skill",
  "description": "自定义 Skill 示例",
  "directory": "my-custom-skill",
  "created_at": "2026-05-18T15:35:24.248164Z"
}

响应字段

响应为 Skill version 对象。
字段类型说明
idstring版本唯一标识符
typestring资源类型，固定为 "skill_version"
skill_idstring所属 Skill 的 ID
versionstring版本号
namestring该版本 SKILL.md frontmatter 的 name
descriptionstring该版本 SKILL.md frontmatter 的 description
directorystringSkill 目录名
created_atstring版本创建时间

错误码

HTTPtype触发条件
400invalid_request_error版本号非数字（含 latest）
401authentication_error缺少或无效的认证令牌
404not_found_errorSkill 不存在，或该版本不存在 / 已删除
完整错误信封说明详见 错误参考。

相关

Agent 技能

为 Agent 附加领域专业知识。
快速入门
构建 Agent
配置 Agent 环境
委派任务给 Agent
集成 Agent
管理 Agent 上下文
账户
最佳实践
公告
API 参考
获取 Skill 版本 - Qoder