跳转到主要内容
GET /api/v1/cloud/skills/{skill_id} 根据 ID 获取单个 Skill 的详细信息。

​
请求头

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

​
路径参数

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

​
查询参数

参数类型必选说明
include_contentboolean否设为 true 时在 content 中返回 base64 编码的 Skill 内容

​
示例请求

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

​
示例响应

HTTP 200 OK 
{
  "id": "skill_019e3bba474b73cfaf19eae9b5f5e66d",
  "type": "skill",
  "display_title": "test-skill-api-doc",
  "description": "A test skill for API documentation",
  "source": "custom",
  "latest_version": "1",
  "metadata": {
    "team": "docs"
  },
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:35:24.248164Z"
}

​
响应字段

字段类型说明
idstringSkill 唯一标识符（skill_ 前缀）
typestring资源类型，固定为 "skill"
display_titlestring由已存储 Skill 名称派生的展示标题
descriptionstringSkill 描述
sourcestringSkill 来源：custom 或 qoder
latest_versionstring最新版本号，字符串格式
metadataobject与 Skill 一起存储的自定义元数据对象；省略时为 {}
contentstringbase64 编码的 Skill 内容；仅在 include_content=true 且内容可读取时返回
content_encodingstring与 content 同时返回，值为 "base64"
created_atstring创建时间（ISO 8601）
updated_atstring最后更新时间（ISO 8601）

​
错误码

HTTPtype触发条件
401authentication_error缺少或无效的认证令牌
404not_found_errorSkill 不存在或不再可访问：Skill '{skill_id}' was not found.
完整错误信封说明详见 错误参考。

​
相关

Agent 技能

为 Agent 附加领域专业知识。