获取 Skill

根据 ID 获取单个 Skill 的详细信息。

GET /v1/skills/{skill_id}

根据 ID 获取单个 Skill 的详细信息。

​

请求头

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

​

路径参数

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

​

查询参数

参数	类型	必选	说明
include_content	boolean	否	设为 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",
  "name": "test-skill-api-doc",
  "description": "A test skill for API documentation",
  "skill_type": "custom",
  "status": "active",
  "version": 1,
  "content_size": 309,
  "content_sha256": "f253cb7d35790025f85917c0c239422cff1de067d00278db8897c585a3f28d94",
  "metadata": {},
  "created_at": "2026-05-18T15:35:24.248164Z",
  "updated_at": "2026-05-18T15:35:24.248164Z"
}

​

响应字段

字段	类型	说明
id	string	Skill 唯一标识符（skill_ 前缀）
type	string	资源类型，固定为 "skill"
name	string	Skill 名称
description	string	Skill 描述
skill_type	string	Skill 类型：custom 或 prebuilt
status	string	状态：active
version	integer	当前版本号
content_size	integer	zip 文件内容大小（字节）
content_sha256	string	内容的 SHA-256 哈希值
metadata	object	自定义元数据
content	string	base64 编码的 Skill 内容；仅在 include_content=true 且内容可读取时返回
content_encoding	string	与 content 同时返回，值为 "base64"
created_at	string	创建时间（ISO 8601）
updated_at	string	最后更新时间（ISO 8601）

​

错误码

HTTP	type	触发条件
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	Skill 不存在或不再可访问：Skill '{skill_id}' was not found.

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

​

相关

Agent 技能

为 Agent 附加领域专业知识。