概述

递归删除一个已安装 Skill 目录，并同步删除该 Skill 的用户隐私配置。未指定 target_uri 时，接口先删除当前用户私有作用域中的同名 Skill；若不存在，再尝试账户共享作用域。

请求接口

URI	`/api/v1/skills/{skill_name}`
请求方法	DELETE
认证	`Authorization: Bearer {API_KEY}`

请求参数

参数	位置	类型	必选	默认值	说明
`skill_name`	Path	string	是	—	待删除的 Skill 名称。
`target_uri`	Query	string	否	null	指定 Skill 根。存在跨作用域同名 Skill 时应显式传入，避免删除错误对象。

响应消息

字段	类型	说明
`result.name`	string	已删除的 Skill 名称。
`result.uri`	string	已删除的 Skill 目录 URI。
`result.root_uri`	string	与 uri 相同。
`result.estimated_deleted_count`	integer	底层删除操作可估算时返回的删除节点数。
`result.privacy_deleted`	bool	是否同时删除了该 Skill 的隐私配置。

完整示例

curl -X DELETE \
  "{BASE_URL}/api/v1/skills/old-skill?target_uri=viking://user/alice/skills" \
  -H "Authorization: Bearer {API_KEY}"

{
  "status": "ok",
  "result": {
    "name": "old-skill",
    "uri": "viking://user/alice/skills/old-skill",
    "root_uri": "viking://user/alice/skills/old-skill",
    "estimated_deleted_count": 4,
    "privacy_deleted": true
  }
}

常见错误

HTTP	error.code	说明
400	`INVALID_ARGUMENT`	skill_name 或 target_uri 非法。
403	`PERMISSION_DENIED`	无目标作用域删除权限。
404	`NOT_FOUND`	待删除 Skill 不存在。

删除前建议

删除是递归操作，会移除 SKILL.md、L0/L1 摘要、辅助文件和来源元数据。生产环境建议先调用查询详情接口并显式指定 target_uri 核对对象，再执行删除。

最近更新时间：2026.07.22 18:07:44

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

概述 #

请求接口 #

请求参数 #

响应消息 #

完整示例 #

常见错误 #